必须正确引入vendor/autoload.php并配置smtp加密参数，安装phpmailer 6.9.x后需检查核心文件存在，显式启用tls/ssl、调用issmtp()、设置smtpauth、使用专用密码及调试模式排查错误。
直接安装 PHPMailer 并确认 autoloader 可用
Composer 安装 PHPMailer 后，vendor/autoload.php 必须被正确引入，否则会报 Class 'PHPMailer\PHPMailer\PHPMailer' not found。别跳过这步——哪怕你用的是 Laravel 或 Symfony，也得确认项目根目录下 vendor/autoload.php 确实存在且路径引用无误。
执行以下命令安装稳定版本（推荐 6.9.x）：
composer require phpmailer/phpmailer:~6.9
安装完成后，检查 vendor/phpmailer/phpmailer/src/ 是否包含 PHPMailer.php、SMTP.php 等核心文件。若使用老旧 PHP 版本（如 7.2），不要强行升级到 7.x 以上版本的 PHPMailer，否则可能触发 Return type declarations 类型错误。
配置 SMTP 连接参数时必须显式启用 TLS/SSL
多数主流邮箱（Gmail、Outlook、腾讯企业邮）要求强制加密连接，但 PHPMailer 默认不启用 TLS，也不自动识别端口对应的加密类型。直接填 smtp.gmail.com 和端口 587 却不设 SMTPSecure，会导致连接超时或认证失败。
-
$mail->isSMTP()必须调用，否则走 mail() 函数，不可靠 -
$mail->Host = 'smtp.qq.com'—— 注意不是smtp.qq.com:587，端口单独设 -
$mail->Port = 587配合$mail->SMTPSecure = 'tls'；若用465则必须设为'ssl' -
$mail->SMTPAuth = true不可省略，否则密码不生效
示例关键片段：
$mail = new PHPMailer\PHPMailer\PHPMailer(); $mail->isSMTP(); $mail->Host = 'smtp.qq.com'; $mail->SMTPAuth = true; $mail->Username = 'your@qq.com'; $mail->Password = 'your-16-digit-smtp-key'; // 注意：不是邮箱登录密码 $mail->SMTPSecure = 'tls'; $mail->Port = 587;
发送失败时优先检查 SMTP 账号权限和错误输出
最常见的“发送无声失败”，其实是 $mail->send() 返回 false，但没打印错误信息。PHPMailer 的 ErrorInfo 属性才是真实线索，不是异常堆栈。
- 务必开启调试：
$mail->SMTPDebug = 2（仅开发环境），避免只看echo 'sent'就以为成功 - QQ 邮箱、163 邮箱等要求开启“SMTP服务”并生成专用密码（非登录密码），在邮箱网页设置里找“POP3/SMTP服务”开关
- Gmail 需启用“两步验证”后生成应用专用密码，且账户需解除“安全性较低的应用访问权限”限制（该选项已下线，必须用专用密码）
- 国内云服务器（如阿里云、腾讯云）默认封禁 25 端口，即使改用 587 也可能被拦截，建议换用企业邮箱或第三方 SMTP 中继（如 SendGrid）
检查失败原因的标准写法：
if (!$mail->send()) {
echo 'Mailer Error: ' . $mail->ErrorInfo;
}
避免在循环中重复 new PHPMailer 实例
批量发送邮件时，有人把 new PHPMailer\PHPMailer\PHPMailer() 放在 for 循环内，每发一封都重建实例、重连 SMTP、重认证——这既慢又容易触发频率限制（比如 QQ 邮箱 1 小时最多 200 封）。正确做法是复用一个实例，只重置收件人和内容。
- 调用
$mail->clearAddresses()和$mail->clearAttachments()清除上一封的收件人与附件 - 用
$mail->addAddress($to)添加新收件人，不要重复设Host、Username等连接参数 - 如果需不同发件人，才考虑新建实例；否则保持单例复用
性能差异明显：100 封邮件，单实例耗时约 8–12 秒；每次 new 耗时可能超过 90 秒，且大概率被 SMTP 服务器拒绝。
真正卡住人的往往不是代码写法，而是 SMTP 账号权限状态、云服务器出站端口策略、以及调试开关是否打开。别急着改代码，先让 $mail->SMTPDebug = 2 输出第一行连接日志。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
