PHP mail函数发送纯文本邮件教程

PHP 的 mail() 函数虽可快速发送纯文本邮件，但实际使用中暗藏诸多陷阱：中文内容默认乱码需手动添加 UTF-8 编码头（Content-Type + MIME-Version + From），换行符必须严格使用 \r\n 而非 \n 或 PHP_EOL，返回 true 仅表示邮件已交予本地邮件传输代理（MTA），绝不等于成功送达，且不支持附件、HTML 邮件或 SMTP 认证等现代需求——一旦业务稍有复杂，就极易陷入编码错误、头信息解析失败、日志无迹可寻的困境；本文直击开发者高频踩坑点，帮你厘清 mail() 的真实能力边界，并明确指出：当需求涉及中文、可靠性、HTML、附件或第三方 SMTP 时，果断切换至 PHPMailer 等专业库才是高效稳健之选。

mail() 函数能发邮件，但默认不带 UTF-8 编码头

直接调用 mail() 发中文内容，收件人看到的大概率是乱码。这不是函数坏了，而是它压根不管字符编码——所有内容都按 ASCII 处理，没加 Content-Type 和 charset 头时，邮箱客户端就猜，一猜就错。

实操上必须手动拼接完整的邮件头：

• Content-Type: text/plain; charset=UTF-8 是底线，缺了中文基本不可读
• MIME-Version: 1.0 要带上，否则某些老邮箱（比如 Outlook 2007）会忽略 charset 声明
• From 头建议用真实邮箱，很多服务器（如 Gmail、腾讯企业邮）会拒收空 From 或格式错误的发件人

示例关键片段：

$headers = "MIME-Version: 1.0\r\n";
$headers .= "Content-Type: text/plain; charset=UTF-8\r\n";
$headers .= "From: admin@example.com\r\n";
mail("user@domain.com", "测试标题", "你好，这是一封中文邮件。", $headers);

换行符必须用 \r\n，不能只用 \n

PHP 的 mail() 底层调用系统 sendmail 或 SMTP 代理，而 RFC 2822 明确要求邮件头与正文之间、各头字段之间必须用 \r\n 分隔。Windows 下用 \n 可能侥幸通过，Linux/macOS 下大概率被截断或报 501 Invalid header 错误。

常见踩坑点：

• 从表单 $_POST 拿来的文本自带 \n，直接拼进邮件体？不行，得统一替换：str_replace("\n", "\r\n", $body)
• 写死的字符串里手敲 \n，忘了改成 \r\n —— 看似正常，其实头和正文粘连，部分邮件客户端解析失败
• 用 PHP_EOL？别用，它随系统变，邮件协议不认这个

发送失败不报错，但 error_log 里藏线索

mail() 返回 true 只代表“交给本地 MTA 了”，不代表对方收到了；返回 false 才算真失败。但多数情况它默默返回 true，而邮件石沉大海——这时候得查系统日志。

排查路径：

• Linux 下看 /var/log/mail.log 或 /var/log/maillog，搜关键词 status=deferred 或 Connection refused
• 确认本地 sendmail/postfix 是否运行：systemctl status postfix（Ubuntu/CentOS 7+）
• 如果用虚拟主机，很多服务商禁用 mail()，直接返回 false，且不给任何提示——这时只能换 PHPMailer 或 SMTP 方式

临时加一行调试：error_log("mail() called with: " . print_r([$to, $subject, $message, $headers], true), 3, "/tmp/mail-debug.log");

大附件、HTML 邮件、认证发信，mail() 不适合

mail() 是个极简接口，只适合发几行纯文本通知（比如注册确认、密码重置链接）。一旦涉及：

• 附件（哪怕一个 PDF）—— 编码、边界符、multipart 构造太容易出错
• HTML 内容 —— 需要同时提供 text/plain 备用版本，mail() 不帮你做
• 用 Gmail/Outlook 等第三方 SMTP 发信 —— 它不支持账号密码认证，没法走 TLS

这些场景硬啃 mail()，90% 时间花在调边界符和 Base64 编码上，而不是业务逻辑。真要用，直接切到 PHPMailer 或 symfony/mailer，它们把编码、连接、重试全包了。

真正难的不是怎么写，是怎么判断该不该用——只要需求里出现“附件”“HTML”“Gmail 账号”“定时重发”，mail() 就该被排除。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。