PHP邮件发送中--PHP-alt-前缀意外出现在正文的终极解决方案-php教程-PHP中文网

PHP邮件发送中--PHP-alt-前缀意外出现在正文的终极解决方案

PHP 8.1+ 中使用 mail() 发送多部分邮件时，若正文开头出现 --PHP-alt-xxx 边界标识，根本原因是换行符不合规（应统一用 \r\n 而非 \n），导致 MIME 结构被错误解析，边界行被误作普通文本写入正文。

php 8.1+ 中使用 mail() 发送多部分邮件时，若正文开头出现 --php-alt-xxx 边界标识，根本原因是换行符不合规（应统一用 \r\n 而非 \n），导致 mime 结构被错误解析，边界行被误作普通文本写入正文。

在 PHP 8.1 及更高版本中，mail() 函数对邮件头与正文的换行规范执行更严格——RFC 5322 明确要求所有邮件头字段与 MIME 部分之间必须使用 CRLF（\r\n）作为行终止符，而早期 PHP（如 5.6）对单 LF（\n）存在容错处理。升级后，若代码中混用 \n 构造多部分邮件体（尤其是 --boundary 行、Content-Type 行、空行等关键位置），MTA（如 sendmail/postfix）将无法正确识别 MIME 分段，进而把本该隐藏的边界标记（如 --PHP-alt-4de4a7c8...）当作纯文本内容原样输出到收件人邮箱正文顶部。

✅ 正确构造 multipart/alternative 邮件的关键修正

你提供的代码中，$body 数组使用 implode("\r\n", $body) 拼接，看似已用 \r\n，但隐患在于：MIME 规范要求每个头部字段后必须紧跟一个空行（即 \r\n\r\n），且各 MIME 部分之间的分隔行（如 --PHP-alt-xxx）本身也必须独占一行，并以 \r\n 结尾。若拼接逻辑遗漏空行或换行不一致，结构即失效。

以下是修复后的完整可运行示例：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

<?php $random_hash = md5(uniqid(time(), true));
$to = 'recipient@example.com';
$subject = 'HTML 邮件测试';
$message_plain = '这是纯文本版本的内容。';
$message_html = '<p>这是<strong>HTML 版本</strong>的内容。';

// ✅ 正确设置 headers（全部使用 \r\n 分隔，且不包含多余空格）
$headers = [
    "From: webmaster@example.com",
    "Reply-To: support@example.com",
    "Content-Type: multipart/alternative; boundary=\"PHP-alt-$random_hash\"",
    "MIME-Version: 1.0"
];
$headers_str = implode("\r\n", $headers) . "\r\n"; // 末尾加 \r\n 确保 headers 与 body 间有空行

// ✅ 正确构造 body：每个 MIME 部分严格遵循 [boundary]\r\n[headers]\r\n\r\n[content]\r\n
$body = [];

// --- Plain text part ---
$body[] = "--PHP-alt-$random_hash";
$body[] = "Content-Type: text/plain; charset=\"utf-8\"";
$body[] = "Content-Transfer-Encoding: 8bit";
$body[] = ""; // ← 关键：空行分隔 header 与 content（必须是 \r\n\r\n）
$body[] = $message_plain;

// --- HTML part ---
$body[] = "--PHP-alt-$random_hash";
$body[] = "Content-Type: text/html; charset=\"utf-8\"";
$body[] = "Content-Transfer-Encoding: 8bit";
$body[] = "";
$body[] = "<meta charset='\"utf-8\"'><title>$subject</title>$message_html";

// --- Final boundary (with trailing --) ---
$body[] = "--PHP-alt-$random_hash--";

// ✅ 最终拼接：全部使用 \r\n，且确保无 \n 混入
$body_str = implode("\r\n", $body) . "\r\n"; // 末尾 \r\n 保证完整性

// 发送
if (mail($to, $subject, $body_str, $headers_str)) {
    echo "✅ 邮件发送成功（含 HTML/TEXT 双版本）";
} else {
    error_log("❌ mail() 返回 false，请检查 MTA 日志");
}

⚠️ 必须注意的 4 个关键点

换行符必须全栈统一为 \r\n：包括 headers 数组元素间、$body 各行间、空行、边界行、结尾行——绝对禁止混用 \n 或 \r；
空行不可省略：每个 MIME 部分的头部与正文之间必须有且仅有一个 \r\n（即空行），这是 RFC 强制要求；
边界字符串需全局一致：headers 中声明的 boundary="..." 必须与 $body 中所有 --PHP-alt-xxx 和 --PHP-alt-xxx-- 完全匹配（含引号、大小写、连字符）；
避免用户输入注入：$random_hash 应使用 md5(uniqid()) 等安全方式生成，切勿拼接用户可控内容到 boundary 或 headers，以防邮件头注入（Header Injection）漏洞。

? 排查建议（当问题仍存在时）

启用 PHP 错误日志：在 php.ini 中设置 log_errors = On + error_log = /var/log/php-mail.log，观察 mail() 调用是否触发警告；
检查 MTA 日志：Linux 下查看 /var/log/mail.log 或 journalctl -u postfix，确认是否因格式错误被拒绝投递；
临时改用 PHPMailer：若生产环境急需稳定，推荐切换至 PHPMailer（支持 SMTP + 自动 MIME 构建），规避底层 mail() 的兼容性陷阱。