PHP发送邮件应使用PHPMailer而非原生mail()函数，因其不依赖系统MTA、支持SMTP认证/TLS/附件/HTML，且兼容现代环境；需注意Gmail应用密码、SPF记录及中文编码等细节。
PHP 发送邮件必须启用 mail() 函数或安装扩展
PHP 自带的 mail() 函数默认不发邮件，它只是调用系统本地 MTA（如 sendmail、Postfix），在大多数现代环境（尤其是 Docker、云服务器、Windows）中直接调用会静默失败或报错 Failed to connect to mailserver。不是代码写错了，而是根本没路可走。
真实可用的路径只有两条：装扩展 + 配置 SMTP，或者用第三方库封装 SMTP。原生 mail() 仅适合老旧的 LAMP 环境且管理员已配好 sendmail。
- Linux 服务器若已运行 Postfix/sendmail，
mail()可能通，但无认证、无 TLS、无法发 Gmail/Outlook 等主流邮箱 - Windows 下
mail()默认不可用，PHP 配置里SMTP和smtp_port仅对mail()生效，但实际兼容性极差 - 所有需要登录、SSL/TLS、自定义端口、附件、HTML 内容的场景，
mail()都不适用
推荐方案：用 PHPMailer（Composer 安装）
这是目前最稳定、文档最全、错误提示最清晰的 PHP 邮件库。它不依赖系统配置，纯 PHP 实现 SMTP 通信，支持 OAuth2、附件、内联图片、多语言编码。
安装命令：
立即学习“PHP免费学习笔记（深入）”；
composer require phpmailer/phpmailer
基础发信示例（以 Gmail 为例）：
$mail = new PHPMailer\PHPMailer\PHPMailer();
$mail->isSMTP();
$mail->Host = 'smtp.gmail.com';
$mail->SMTPAuth = true;
$mail->Username = 'your@gmail.com';
$mail->Password = 'your_app_password'; // 注意：不是登录密码，是 Google 账户里生成的「应用专用密码」
$mail->SMTPSecure = 'tls';
$mail->Port = 587;
$mail->setFrom('your@gmail.com', 'Your Name');
$mail->addAddress('to@example.com');
$mail->Subject = 'Hello from PHPMailer';
$mail->Body = '<p>This is an <strong>HTML</strong> email</p>';
if (!$mail->send()) {
echo 'Error: ' . $mail->ErrorInfo;
}
- Gmail 必须开启两步验证，并在账户设置中生成「应用专用密码」，填入
Password字段 - 国内阿里云、腾讯云服务器常被 Gmail/Outlook 拒收，建议改用企业邮箱 SMTP 或 Mailgun/SendGrid 等服务
-
SMTPSecure值为'tls'或'ssl'，对应端口分别为587和465；填错会导致连接超时
替代方案：用 SwiftMailer（已归档，不建议新项目）
SwiftMailer 曾是 Laravel 的默认邮件组件，但官方已于 2021 年停止维护。虽仍能用，但存在已知 TLS 1.3 兼容问题、无 PHP 8.2+ 全面测试，且错误信息不如 PHPMailer 直观。
如果你维护老项目且已用 SwiftMailer，可继续用；新项目请直接选 PHPMailer 或更轻量的 symfony/mailer（需 Symfony 组件生态）。
- SwiftMailer 的
send()返回int（成功发了几封），不是布尔值，容易误判失败 - 配置 SMTP 时需手动 new
Swift_SmtpTransport，再传给Swift_Mailer，步骤比 PHPMailer 多一层 - 不支持 Gmail 的应用专用密码自动识别，需手动指定加密方式和端口
关键避坑点：字符编码、换行符、DNS 与 SPF
即使 SMTP 连通、账号正确，邮件仍可能进垃圾箱或显示乱码——这不是 PHP 的问题，而是邮件协议细节没对齐。
- 中文主题必须用
mb_encode_mimeheader()编码，否则 Outlook 会显示问号：$mail->Subject = mb_encode_mimeheader('你好世界', 'UTF-8', 'B'); - HTML 正文必须设
$mail->isHTML(true)，否则会被当纯文本渲染 - 发信域名必须有有效的 SPF 记录（如
v=spf1 include:_spf.google.com ~all），否则 Gmail 会拒收或标为垃圾邮件 - 测试时别只看是否“发送成功”，一定要查收件箱、垃圾箱、查看原始邮件头（Raw Message）确认
Return-Path和Authentication-Results
SMTP 是个老协议，容错低。一个空格、一个换行、一个没转义的引号，都可能导致整个邮件被 MTA 丢弃——别怪 PHP，怪的是 RFC 5322。
