PHP的mail()函数仅将邮件交予本地MTA，不保证发送成功；生产环境应改用PHPMailer等SMTP库，确保TLS认证、错误调试与合规签名。
PHP 自带的 mail() 函数在大多数现代生产环境中无法直接发信——它依赖本地 sendmail 或 SMTP 代理，而云服务器、Docker 容器、共享主机普遍禁用或未配置该服务。真要稳定发邮件，必须走 SMTP 协议，并用可靠库封装连接、认证与错误处理。
为什么 mail() 在绝大多数情况下会静默失败
调用 mail() 返回 true 只代表“把信交给了本地 MTA”，不代表邮件已发出或送达。常见失效场景包括：
- Linux 容器里根本没装
sendmail或postfix - 腾讯云/阿里云默认屏蔽 25 端口，
mail()尝试直连 SMTP 时超时 - 收件方（如 QQ 邮箱）拒收无 SPF/DKIM 签名、无反向 DNS 的源 IP 发出的邮件
- 错误日志被 PHP 错误抑制（
error_reporting(0)）或写入不可见位置
验证方式：临时加一行 error_log(print_r(error_get_last(), true), 3, '/tmp/php-mail.log'); 查看底层报错；但更推荐直接弃用 mail()。
用 PHPMailer 发带附件和 HTML 的邮件（Composer 方式）
不推荐手动拼接 MIME 头或用 cURL 模拟 SMTP——容易漏掉 TLS 协商、AUTH LOGIN 流程、换行符规范（CRLF）、编码转义等细节。PHPMailer 是经过大量邮件服务商实测的成熟封装。
立即学习“PHP免费学习笔记（深入）”；
安装与基础发送：
composer require phpmailer/phpmailer
最小可用示例（以 Gmail SMTP 为例）：
$mail = new PHPMailer\PHPMailer\PHPMailer();
$mail->isSMTP();
$mail->Host = 'smtp.gmail.com';
$mail->Port = 587;
$mail->SMTPAuth = true;
$mail->Username = 'your@gmail.com';
$mail->Password = 'your-app-password'; // 注意：不是登录密码，是 Google 账户里生成的“应用专用密码”
$mail->SMTPSecure = 'tls';
$mail->setFrom('your@gmail.com', '发件人名称');
$mail->addAddress('to@example.com');
$mail->Subject = '测试邮件';
$mail->isHTML(true);
$mail->Body = '<h2>这是一封 HTML 邮件</h2><p>支持 <strong>加粗</strong></p>';
$mail->AltBody = '这是纯文本备选内容';
if (!$mail->send()) {
error_log('邮件发送失败: ' . $mail->ErrorInfo);
}
关键点：
-
SMTPSecure值为'tls'时，Port必须是587；若用'ssl'，则端口应为465（部分服务商已弃用 SSLv3） - Gmail 必须开启两步验证并生成“应用专用密码”，直接填账户密码会报
SMTP Error: Authentication failed - 国内企业邮箱（如网易企业邮、腾讯企业邮）通常要求使用域名邮箱（
user@your-company.com），且需在控制台开启 SMTP 服务并获取授权码 - 附件用
$mail->addAttachment('/path/to/file.pdf')，路径必须是服务器上的绝对路径或可读流
发信失败时如何快速定位问题
别只看 $mail->send() 返回值。启用调试模式后，PHPMailer 会输出完整 SMTP 交互日志：
$mail->SMTPDebug = 2; // 1=客户端消息，2=客户端+服务端通信
$mail->Debugoutput = function($str) {
error_log('[PHPMailer] ' . trim($str));
};
典型错误及应对：
-
SMTP connect() failed→ 检查防火墙是否放行目标端口（telnet smtp.qq.com 587测试连通性） -
Authentication unsuccessful→ 核对用户名是否含域名（user@domain.com）、密码是否为授权码、是否开启了 SMTP 服务 -
Message body empty→$mail->Body或$mail->AltBody为空字符串，注意isHTML(true)后仍需提供纯文本备选 -
Could not instantiate mail function→ Composer 自动加载失败，确认vendor/autoload.php已引入
真正麻烦的不是发不出去，而是发出去了却被当垃圾邮件——这取决于 SPF 记录、DMARC 策略、发信频率、内容关键词、IP 历史信誉。小项目用 Gmail 或腾讯企业邮起步没问题；用户量上来后，务必迁移到 SendGrid / Mailgun / Amazon SES 这类专业服务，并配好 DNS 记录。否则一封投诉，整个域名邮箱就进黑名单了。
