PHPMailer 是解决 PHP 邮件发送不可靠问题的必备方案，因 mail() 函数缺乏 SMTP 认证、TLS/SSL 加密及发件人验证机制，易被拒收；必须通过显式 SMTP（如 Gmail 的 smtp.gmail.com:587）配合应用专用密码、SPF/DKIM 配置才能稳定送达。
PHPMailer 不是 PHP 内置功能，直接调用 mail() 函数发邮件在现代生产环境基本不可靠——99% 的失败源于配置缺失、认证未启用或被当成垃圾邮件拦截。
为什么 mail() 函数发不出去？
Linux 下 mail() 依赖本地 sendmail 或 msmtp；Windows 几乎默认失效。更关键的是：它不支持 SMTP 认证、无 TLS/SSL 控制、无法自定义 Return-Path，Gmail、Outlook 等主流邮箱会直接拒收或打入垃圾箱。
- 错误现象：
mail() returns true但收件人永远收不到，或收到后显示“未验证发件人” - 真实原因：没有设置
From头的域名与发送服务器 MX 记录匹配，且缺乏 SPF/DKIM 配置支撑 - 替代方案：必须走显式 SMTP（如 Gmail 的
smtp.gmail.com:587），由 PHPMailer 封装连接、认证、加密全过程
PHPMailer 最小可用配置（Gmail 示例）
不是所有参数都要填，但以下 5 项缺一不可，否则连接失败或被拒绝：
-
$mail->isSMTP()—— 必须显式声明，否则默认走mail() -
$mail->Host = 'smtp.gmail.com'—— 注意不是gmail-smtp.l.google.com等别名 -
$mail->Port = 587—— Gmail 推荐 STARTTLS 端口；465（SSL）需配合$mail->SMTPSecure = 'ssl' -
$mail->SMTPAuth = true—— 关闭则认证跳过，Gmail 直接 535 错误 -
$mail->Username = 'your@gmail.com'和$mail->Password = 'app-specific-password'—— 2022 年起 Gmail 强制要求应用专用密码，普通密码会报534-5.7.9 Application-specific password required
$mail = new PHPMailer\PHPMailer\PHPMailer();
$mail->isSMTP();
$mail->Host = 'smtp.gmail.com';
$mail->Port = 587;
$mail->SMTPAuth = true;
$mail->SMTPSecure = 'tls'; // 不是 'starttls'，PHPMailer 内部已映射
$mail->Username = 'me@gmail.com';
$mail->Password = 'abcd efgh ijkl mnop'; // 16位空格分隔，从 Google 账户「安全性→应用专用密码」生成
$mail->setFrom('me@gmail.com', 'My Site');
$mail->addAddress('user@example.com');
$mail->Subject = 'Test';
$mail->Body = 'Hello';
$mail->send();
常见报错与对应修复点
错误信息里藏着最准的线索，别急着搜“PHPMailer 发不了邮件”，先看具体提示：
立即学习“PHP免费学习笔记（深入）”；
-
SMTP Error: Could not authenticate→ 检查Username是否为完整邮箱地址；Password是否为应用专用密码（非登录密码）；Gmail 账户是否开启「两步验证」（未开启则无法生成专用密码） -
Connection failed: stream_socket_enable_crypto(): ssl operation failed→SMTPSecure值错误，或 PHP 缺少 OpenSSL 扩展（php -m | grep openssl验证） -
Message body empty→$mail->Body或$mail->AltBody为空字符串，注意空格、换行符、BOM 头都可能导致该判断失败 - 收件箱有邮件但显示「来自：xxx via smtp.gmail.com」→
setFrom()域名与Host不一致，Gmail 强制改写发件人，应统一使用 Gmail 域名
生产环境必须加的三道防护
开发能发 ≠ 上线能用。忽略这些，流量一上来就进队列积压或触发服务商限流：
- 启用
$mail->SMTPOptions = ['ssl' => ['verify_peer' => false]]仅限测试；生产必须保持verify_peer => true，否则证书校验失败导致随机中断 - 添加超时控制：
$mail->Timeout = 15、$mail->SMTPDebug = 0（上线前关掉调试，否则日志暴露出口密码） - 发信频率限制：Gmail 免费账号上限约 500 封/天；若需群发，必须用
$mail->addBCC()单连接多收件，而非循环send()—— 后者极可能被标记为滥发
真正难的从来不是“怎么发出去”，而是“怎么让对方邮箱信任你”。PHPMailer 只解决传输链路，域名验证、反向 DNS、发信频率策略、退订链接合规性，这些才是决定送达率的关键。
