PHP mail() 因依赖本地MTA（如sendmail）且不支持SMTP认证，在Windows/Mac/Docker等环境常失败；必须用PHPMailer直连SMTP，显式调用isSMTP()、正确配置端口加密、UTF-8编码及转义用户输入，并用MailHog或SMTPDebug调试。
PHP mail() 函数为什么经常发不出去
直接调用 mail() 发邮件，在本地开发环境或共享主机上大概率失败，不是代码写错了，而是它根本没走 SMTP 协议，而是依赖服务器本地的 sendmail 或 postfix 服务——而绝大多数 Windows 环境、Mac 默认、以及很多 Docker 容器里压根没配这个。
常见错误现象：mail() 返回 true 但收件人永远收不到；日志里出现 Failed to connect to mailserver；邮件进垃圾箱且无追踪头信息。
- 必须确认服务器已安装并运行了 MTA（如
sendmail），且 PHP 的sendmail_path配置指向正确二进制路径 -
mail()不支持用户名密码认证，无法对接 Gmail、QQ 邮箱等需要 SMTP 登录的主流服务 - 发信头（From、Reply-To）若不规范，会被 GMail / Outlook 直接拒收或标为垃圾邮件
- 没有连接超时、重试、错误详情反馈，调试困难
PHPMailer 是什么情况下必须用
当你需要发带附件、HTML 内容、多收件人、自定义 SMTP（比如用腾讯企业邮箱或 Mailgun）、或者要拿到明确的发送失败原因时，PHPMailer 就不是“可选”，而是事实标准。
它绕过了系统 MTA，直连 SMTP 服务器，所有认证、加密（TLS/SSL）、编码、头部构造都由 PHP 层控制，可控性高得多。
立即学习“PHP免费学习笔记（深入）”；
- 必须用 Composer 安装：
composer require phpmailer/phpmailer，手动下载 zip 包容易漏依赖 - 别用网上搜到的“精简版”或“单文件 PHPMailer”，那些往往是过时、删了异常处理、甚至有安全漏洞的老版本
-
isSMTP()必须显式开启，否则仍会 fallback 到mail()，你以为在走 SMTP，其实没走 - 端口和加密方式要严格匹配服务商要求：Gmail 用
587+TLS，QQ 邮箱用465+SSL，错一个就连接拒绝
发 HTML 邮件时 Content-Type 和编码怎么设才不乱码
HTML 邮件不是把 <html> 塞进去就行，MIME 结构、字符集、换行符全得对，否则 Outlook 显示空白、手机端文字堆成一团、中文变问号。
PHPMailer 默认会处理大部分，但两个地方你得盯紧：
- 正文必须用
$mail->Body = '<p>你好</p>';，别用$mail->MsgHTML()自动转义后又手动加<html>头——它会重复生成 MIME boundary - 务必显式设置：
$mail->CharSet = 'UTF-8';，否则某些老 SMTP 服务器（如部分国内 IDC）会当默认 ISO-8859-1 处理，中文直接报废 - 如果内容含用户输入，
$mail->Body里不要直接拼接，先用htmlspecialchars()或htmlentities()转义，否则可能被注入恶意标签或脚本（虽然多数邮箱会过滤 JS，但结构破坏风险仍在）
测试阶段怎么快速验证邮件逻辑是否真通
别一上来就填真实邮箱狂点发送，浪费时间还可能被服务商限流。本地开发时，优先走“假 SMTP”或日志输出。
- 用
smtp.gmail.com测试前，先关掉 Gmail 的“低安全性应用访问”，改用“应用专用密码”（需开启两步验证） - 更推荐用
MailHog或MailCatcher：启动一个本地 SMTP 接收服务，所有mail()或 PHPMailer 发出的邮件都会被捕获，网页就能看原始内容、头信息、编码，不用发、不污染收件箱 - 在代码里临时加一句：
$mail->SMTPDebug = 2;（注意是数字 2，不是字符串），能看到完整的 SMTP 交互日志，比查错误码快十倍 - 别忽略返回值：
if (!$mail->send()) { echo $mail->ErrorInfo; }—— 很多人只看send()的布尔值，却跳过这个关键错误描述
真正麻烦的从来不是“怎么发”，而是“发出去之后谁收到了、谁没收到、为什么没收到”。SMTP 认证、DNS 解析、SPF/DKIM 配置、发信频率限制……这些不在 PHP 代码里，但决定你的邮件到底能不能落地。先让一封测试邮件稳稳进收件箱，再谈业务逻辑。
