WordPress中wp_mail()与PHPMailer多部分邮件配置及过滤器问题

我来帮你拆解这个问题——在WordPress里用wp_mail()或直接操作PHPMailer时，多部分邮件的边界缺失确实是个常见坑，下面分点给你讲清楚解决方案：

一、直接操作PHPMailer实例（最可靠的方式） #

WordPress的wp_mail()底层就是用PHPMailer实现的，所以你完全可以通过phpmailer_init动作钩子直接修改PHPMailer实例，根本不用手动处理边界——PHPMailer会自动帮你生成合法的边界字符串，适配多部分邮件的需求。

给你一个实用的代码示例：

add_action('phpmailer_init', function($phpmailer) {
    // 开启HTML模式，同时支持纯文本备选内容
    $phpmailer->isHTML(true);
    // 指定多部分类型（针对HTML+纯文本的场景）
    $phpmailer->ContentType = 'multipart/alternative';

    // 设置邮件内容：HTML版本和纯文本版本
    $phpmailer->Body = '<p>这是<strong>HTML格式</strong>的邮件内容</p>';
    $phpmailer->AltBody = '这是纯文本格式的邮件内容';

    // 如果需要添加附件，PHPMailer会自动切换为multipart/mixed类型并生成对应边界
    $phpmailer->addAttachment('/path/to/your/document.pdf', '月度报告.pdf');

    // 注：除非你有特殊需求，否则不要手动设置边界！PHPMailer自动生成的边界更可靠
    // $phpmailer->boundary = md5(time());
});

当你同时设置Body和AltBody，或者添加附件时，PHPMailer会自动调整ContentType并生成唯一的边界，完全避免手动拼接邮件头的错误。

二、过滤器是否可行？ #

可行，但不如直接操作PHPMailer实例靠谱。WordPress提供了wp_mail_content_type、wp_mail_headers这类过滤器，但手动修改邮件头容易和PHPMailer的自动逻辑冲突，导致边界不匹配。

如果一定要用过滤器，示例如下（不推荐，仅作参考）：

// 修改邮件内容类型为多部分
add_filter('wp_mail_content_type', function() {
    return 'multipart/alternative';
});

// 手动添加边界头（风险高，可能和PHPMailer自动生成的边界冲突）
add_filter('wp_mail_headers', function($headers) {
    $boundary = md5(time());
    $headers .= "Content-Type: multipart/alternative; boundary=\"$boundary\"\r\n";
    return $headers;
});

再次提醒：这种方式很容易出问题，因为PHPMailer内部可能会覆盖你手动设置的边界，导致邮件头和实际内容不匹配。

三、如何把这些代码添加到项目中？ #

你有几个常用的途径：

• 直接复制到当前主题的functions.php文件末尾（注意备份，避免主题更新丢失）
• 编写一个简单的自定义插件，把代码放在插件的主文件里（推荐，主题更新不影响）
• 使用Code Snippets这类代码片段插件，可视化添加代码，无需修改主题文件

举个放在functions.php里的完整例子：

// 自定义配置多部分邮件
add_action('phpmailer_init', 'my_custom_multipart_email_setup');
function my_custom_multipart_email_setup($phpmailer) {
    $phpmailer->isHTML(true);
    $phpmailer->Body = '<h2>你好！</h2><p>这是一封测试多部分邮件</p>';
    $phpmailer->AltBody = '你好！这是一封测试多部分邮件';
    // 添加主题目录下的附件
    $phpmailer->addAttachment(get_template_directory() . '/assets/guide.pdf', '使用指南.pdf');
}

四、是否需要用remove_filter()移除过滤器？ #

看你的使用场景：

• 如果这个配置是全局生效的（比如网站所有邮件都要发送HTML+纯文本版本），完全不需要移除，让它一直生效即可。
• 如果只是在特定场景下使用（比如只有某个表单提交时才发多部分邮件），那一定要在发送完邮件后移除过滤器/动作，避免影响其他邮件的发送逻辑。

给你一个场景化的示例：

// 仅在发送订单通知时启用多部分配置
function send_order_notification($recipient) {
    // 添加临时的PHPMailer配置动作
    add_action('phpmailer_init', 'temp_order_email_config');
    
    // 发送邮件（这里内容可以留空，因为我们在动作里已经设置了Body和AltBody）
    wp_mail($recipient, '你的订单已确认', '');
    
    // 移除动作，避免影响其他邮件
    remove_action('phpmailer_init', 'temp_order_email_config');
}

function temp_order_email_config($phpmailer) {
    $phpmailer->isHTML(true);
    $phpmailer->Body = '<p>尊敬的客户，你的订单已确认，详情请查看附件</p>';
    $phpmailer->AltBody = '尊敬的客户，你的订单已确认，详情请查看附件';
    $phpmailer->addAttachment(WP_CONTENT_DIR . '/uploads/orders/1234.pdf', '订单1234.pdf');
}

这样只有调用send_order_notification()时，才会应用这个多部分邮件配置，其他邮件还是按默认逻辑发送。

内容的提问来源于stack exchange，提问作者Robibob