mail()函数发中文邮件需手动设置utf-8编码头,否则乱码;必须用\r\n换行;返回true不保证送达;复杂需求应改用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() 就该被排除。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











