php的mail()函数默认依赖本地sendmail或smtp服务，而现代开发环境大多未配置，导致静默失败；可靠方案是绕过mail()直连smtp，推荐使用phpmailer处理tls/ssl、认证等复杂细节。
PHP用mail()函数发不了邮件，为什么
绝大多数情况下，mail()根本发不出去——不是代码写错，是它默认依赖本地sendmail或SMTP服务，而现代开发环境（尤其是Windows、Docker、Mac M1/M2、共享主机）基本没配这个。错误现象通常是静默失败，或者返回true但收件人永远收不到。
真正能落地的方案，是绕过mail()，直连SMTP服务器。别被“PHP原生支持”误导，那只是接口存在，不代表能用。
- Linux服务器若未安装并配置
sendmail或postfix，mail()必挂 - Windows下
mail()默认不可用，除非手动改php.ini里的SMTP和smtp_port，且仅支持无认证的老旧SMTP - 即使配置成功，
mail()不支持TLS/SSL、不支持OAuth2、无法可靠处理附件或HTML正文
用PHPMailer发SMTP邮件最稳的配置要点
不用PHPMailer？可以，但得自己手撸SMTP协议（不推荐）。用它不是因为“流行”，而是它把STARTTLS、证书验证、编码转换、换行符归一化这些坑全兜住了。
关键不是“怎么装”，而是配置时几个参数稍错一点就报SMTP Error: Could not authenticate或Connection failed：
立即学习“PHP免费学习笔记（深入）”；
-
$mail->isSMTP()必须调用，否则走mail()回退路径 -
$mail->Host = 'smtp.gmail.com'：Gmail用这个；腾讯企业邮箱是smtp.exmail.qq.com；阿里云企业邮箱是smtp.mxhichina.com——不能凭印象写 -
$mail->Port = 587对应SMTPAuth+ STARTTLS；465对应SSL（部分服务商已弃用） -
$mail->SMTPAuth = true必须设为true，否则密码白给 - 用户名不是邮箱全名？比如腾讯企业邮箱可能要求
username@domain.com，而密码必须是“SMTP专用密码”（非登录密码），在邮箱后台开启并生成
示例关键段：
$mail = new PHPMailer\PHPMailer\PHPMailer();
$mail->isSMTP();
$mail->Host = 'smtp.gmail.com';
$mail->Port = 587;
$mail->SMTPAuth = true;
$mail->SMTPSecure = 'tls'; // 不是'ssl'，也不是空字符串
$mail->Username = 'your@gmail.com';
$mail->Password = 'your-app-password'; // Gmail必须用App Password
$mail->setFrom('your@gmail.com', 'Your Name');
$mail->addAddress('to@example.com');
$mail->Subject = 'Test';
$mail->Body = '<p>Hello</p>';
$mail->isHTML(true);
发信失败时看哪几行Exception消息
别一看到报错就搜“PHPMailer SMTP Error”，先盯住echo $mail->ErrorInfo输出的原始信息。真实线索藏在里面：
-
SMTP Error: Could not connect to SMTP host→ 网络不通或Host/Port写反（比如把587写成25） -
SMTP Error: Authentication failed→ 用户名/密码错，或没开SMTP服务，或用了登录密码而非应用专用密码 -
SMTP Error: Data not accepted→ 收件人地址格式非法、主题含非法字符、HTML正文没调isHTML(true) -
Unable to find the socket transport "ssl"→ PHP没编译openssl扩展，运行php -m | grep openssl确认
调试阶段务必加$mail->SMTPDebug = 2，它会打印完整SMTP交互日志，比猜强十倍。
用sendmail替代SMTP？只适合特定场景
如果你真在Linux服务器上跑，且能控制sendmail或postfix配置，那用mail()反而更轻量。但它和SMTP不是“二选一”的功能差异，而是部署层级不同：
- SMTP方式：PHP直连远程邮件服务商，依赖网络和对方策略（如Gmail每天100封限额）
-
sendmail方式：PHP调本地命令，由本地MTA负责投递，适合内网系统通知、日志告警等不强调收件人即时性的场景 - 用
sendmail前先终端执行which sendmail，再检查php.ini里sendmail_path是否指向正确路径（常见坑：/usr/sbin/sendmail -t -i漏了-t） - 本地MTA若没配SPF/DKIM，发到Gmail/Outlook大概率进垃圾箱——这问题SMTP方式同样存在，但至少你能控制发信IP和域名信誉
没有万能方案。小项目用Gmail SMTP+App Password最快；企业内网用sendmail省事；高并发或合规要求严的，得上Mailgun/SendGrid这类API服务。
