WordPress 郵件系統深度定制：HTML 內容、發件人偽裝、SMTP 接入全攻略

前言：wp_mail() 是核心，但默認配置極其簡陋

WordPress 通過 wp_mail() 發送所有郵件（註冊通知、密碼重置、評論提醒、表單投遞等）。默認配置存在三大痛點：

1. 純文本模式：Content-Type 為 text/plain，無法發送富文本
2. 發件人固定：WordPress <wordpress@yourdomain.com>，易進垃圾箱、不可回覆
3. 依賴 PHP mail()：眾多主機禁用或限制，送達率極低

本文提供純代碼方案解決前兩點，並推薦SMTP 插件方案徹底解決送達率問題。

一、啟用 HTML 郵件內容

<?php
// functions.php
/**
 * 將所有 wp_mail() 內容類型設置為 text/html
 */
function my_wp_mail_content_type() {
    return 'text/html';
}
add_filter('wp_mail_content_type', 'my_wp_mail_content_type');
?>

啟用後，wp_mail() 的 $message 參數可直接包含 HTML 標籤。注意：此過濾器全局生效，若部分郵件需純文本，需在具體調用處臨時移除過濾器：

// 某處需要純文本
remove_filter('wp_mail_content_type', 'my_wp_mail_content_type');
wp_mail($to, $subject, $plain_text_message);
add_filter('wp_mail_content_type', 'my_wp_mail_content_type');

二、自定義發件人名稱與郵箱

<?php
// functions.php
/**
 * 自定義發件人名稱
 */
function my_wp_mail_from_name($name) {
    return '我的品牌名稱'; // 如：Acme Corp、博客名
}
add_filter('wp_mail_from_name', 'my_wp_mail_from_name');

/**
 * 自定義發件人郵箱
 */
function my_wp_mail_from($email) {
    return 'no-reply@mydomain.com'; // 必須為真實存在、可接收郵件的地址
}
add_filter('wp_mail_from', 'my_wp_mail_from');
?>

最佳實踐：

• 發件郵箱使用子域名（如 noreply@mail.mydomain.com），隔離主域名信譽
• 設置 Reply-To 頭指向真實客服郵箱，方便用戶回覆
• 配合 SPF/DKIM/DMARC 域名解析，大幅提升送達率

三、wp_mail() 完整參數與高級用法

wp_mail(
    string|array $to,           // 收件人：字符串或數組，多地址用逗號分隔
    string $subject,            // 主題
    string $message,            // 內容（HTML 或純文本）
    string|array $headers = '', // 額外頭：From、Cc、Bcc、Reply-To、Content-Type 等
    string|array $attachments = '' // 附件路徑：數組或換行分隔字符串
): bool

實戰範例

<?php
// 1. 基礎發送
wp_mail('user@example.com', '歡迎註冊', '歡迎加入我們！');

// 2. HTML 郵件 + 多收件人 + 抄送 + 附件
$to = ['user1@example.com', 'user2@example.com'];
$subject = '月度報告';
$message = '<h1>月度報告</h1><p>詳見附件</p>';
$headers = [
    'From: 報告系統 <reports@mydomain.com>',
    'Cc: manager@mydomain.com',
    'Reply-To: support@mydomain.com',
    'Content-Type: text/html; charset=UTF-8',
];
$attachments = [
    WP_CONTENT_DIR . '/uploads/reports/monthly_202401.pdf',
];
wp_mail($to, $subject, $message, $headers, $attachments);

// 3. 批量發送（建議使用隊列，避免超時）
$users = get_users(['fields' => 'ID']);
foreach ($users as $user) {
    $email = $user->user_email;
    // 推薦：放入 Redis 隊列，Worker 異步發送
    // wp_mail($email, ...);
}
?>

四、徹底解決送達率：SMTP 方案（推薦）

PHP mail() 依賴本地 MTA（Postfix/Sendmail），配置複雜、IP 信譽差、無日誌可查。**SMTP 直接使用郵件服務商服務器**，是生產環境標準做法。

推薦插件：WP Mail SMTP（官方/免費版功能足夠）

1. 安裝啟用 WP Mail SMTP
2. 設置 → WP Mail SMTP → 設置
3. 郵件發送商選擇：

關鍵設置項

• From Email：與 SMTP 賬號一致或經驗證的別名
• From Name：品牌名稱
• Encryption：SSL（465 端口）或 TLS（587 端口）
• Auto TLS：勾選
• Authentication：開啟，輸入 SMTP 用戶名/密碼（或授權碼）

測試驗證

插件設置頁面底部有「發送測試郵件」功能，務必測試：

1. 收件箱是否收到
2. 是否進垃圾箱（檢查 SPF/DKIM）
3. HTML 內容渲染是否正常
4. 附件是否正常
5. 回覆地址是否正確

五、進階：編程式切換 SMTP 配置（多場景）

<?php
// 根據場景動態切換發件配置
function my_dynamic_smtp($phpmailer) {
    $is_order = strpos($phpmailer->Subject, '訂單') !== false;
    
    if ($is_order) {
        // 訂單郵件走專用事務郵件通道
        $phpmailer->isSMTP();
        $phpmailer->Host = 'smtp.sendgrid.net';
        $phpmailer->Port = 587;
        $phpmailer->SMTPSecure = 'tls';
        $phpmailer->Username = 'apikey';
        $phpmailer->Password = 'SG.xxx';
        $phpmailer->From = 'orders@mydomain.com';
        $phpmailer->FromName = '訂單系統';
    }
}
add_action('phpmailer_init', 'my_dynamic_smtp');
?>

六、常見問題排查表

總結

WordPress 郵件系統定制三步走：

1. 代碼層：wp_mail_content_type 啟用 HTML，wp_mail_from/wp_mail_from_name 定制發件人
2. 基礎設施層：必須接入 SMTP（WP Mail SMTP 插件），棄用 PHP mail()
3. 域名信譽層：配置 SPF/DKIM/DMARC，使用子域名隔離業務流量

遵循此路徑，可將郵件送達率從「不可用」提升至「企業級可靠」。