PHP项目邮件发送失败时，应优先采用PHPMailer直连SMTP（支持SSL/TLS、应用密码认证）；其次可配置php.ini系统级转发（仅Windows稳定）、Swift Mailer扩展传输层、MailHog本地调试或FakeSendmail兼容旧代码。
如果您的PHP项目需要向用户发送注册确认、密码重置或系统通知类邮件，但当前无法正常投递，则很可能是由于默认的mail()函数依赖本地MTA且缺乏身份验证与加密支持。以下是多种可立即实施的SMTP邮件服务配置方法：
一、使用PHPMailer库直连第三方SMTP服务
PHPMailer是目前最成熟稳定的PHP邮件发送库，支持SSL/TLS加密、HTML正文、附件及详细错误反馈，无需修改服务器全局配置即可在任意环境运行。
1、通过Composer安装：composer require phpmailer/phpmailer
2、在PHP脚本中引入自动加载文件：require 'vendor/autoload.php';
立即学习“PHP免费学习笔记（深入）”；
3、实例化PHPMailer对象并启用SMTP模式：$mail->isSMTP()
4、设置SMTP主机地址（如QQ邮箱为smtp.qq.com，Gmail为smtp.gmail.com）
5、指定端口与加密方式：端口465必须配'ssl'，端口587必须配'tls'
6、开启认证并填入邮箱账号与应用专用密码（非登录密码）：$mail->Username = 'your@domain.com'; $mail->Password = '16-digit-app-code';
7、确保setFrom()邮箱地址与Username完全一致，否则触发535 Authentication failed
8、调用send()方法发送，并用try-catch捕获异常以获取$mail->ErrorInfo
二、配置php.ini启用系统级SMTP转发
该方法使所有调用mail()函数的代码自动经由指定SMTP服务器中转，适用于无法修改业务代码的遗留系统，但需服务器管理员权限且仅限Windows平台稳定可用。
1、打开php.ini文件，定位[mail function]区域
2、设置SMTP服务器地址：SMTP = smtp.163.com
3、设置端口：smtp_port = 465
4、填写发件人邮箱：sendmail_from = your_email@163.com
5、确认php_openssl扩展已启用：extension=openssl（Linux）或extension=php_openssl.dll（Windows）
6、重启Web服务器（Apache/Nginx）与PHP-FPM进程使配置生效
三、使用Swift Mailer构建可扩展邮件传输层
Swift Mailer采用面向对象设计，支持事件监听、插件机制与多种传输方式（SMTP、Sendmail、Mail），适合需要精细控制邮件生命周期或集成队列系统的项目。
1、执行Composer命令安装：composer require swiftmailer/swiftmailer
2、创建SMTP传输对象：$transport = (new \Swift_SmtpTransport('smtp.qq.com', 587, 'tls'));
3、设置认证凭证：$transport->setUsername('your@qq.com')->setPassword('app-auth-code');
4、构建邮件消息对象，设置发件人、收件人、主题与HTML正文
5、创建Mailer实例并发送：$mailer = new \Swift_Mailer($transport); $mailer->send($message);
四、本地开发环境使用MailHog捕获调试邮件
MailHog是一个轻量级本地SMTP服务器，不真实投递邮件，而是将所有发出的邮件捕获至Web界面供查看与调试，专为开发阶段设计，避免误发测试邮件。
1、下载MailHog二进制文件（支持Windows/macOS/Linux），直接运行无依赖
2、启动服务后，默认监听1025端口（SMTP）与8025端口（Web UI）
3、在PHPMailer中配置：$mail->Host = 'localhost'; $mail->Port = 1025; $mail->SMTPAuth = false;
4、在浏览器中访问http://localhost:8025查看所有已捕获邮件的原始头信息与HTML渲染效果
5、无需配置用户名密码，所有邮件均被拦截存档，不经过任何外部网络
五、通过FakeSendmail在Windows下模拟sendmail行为
FakeSendmail是一个命令行工具，将PHP的mail()函数调用转换为对真实SMTP服务器的TLS/SSL连接请求，使旧代码无需重构即可使用第三方邮箱服务。
1、下载FakeSendmail并解压至C:\xampp\sendmail\目录
2、编辑sendmail.ini文件，填写以下关键项：smtp_server=smtp.gmail.com、smtp_port=587、auth_username=your@gmail.com、auth_password=your-16-digit-app-password
3、在php.ini中取消注释并修改sendmail_path：sendmail_path = "C:\xampp\sendmail\sendmail.exe -t"
4、重启Apache服务，原有mail()调用即自动走FakeSendmail通道
