OVH共享主机上PHPMailer必须使用其官方SMTP服务ssl0.ovh.net:465并启用SSL认证，因OVH默认屏蔽所有外发SMTP连接；Username须为已激活的OVH邮箱完整地址，Password为该邮箱登录密码，且SMTPSecure必须设为'ssl'。
PHPMailer 不是“插件”，它是独立的 PHP 类库，用错概念会导致引入失败或自动加载异常。直接上手配置前，先确认你面对的是哪种环境限制——本地开发、共享主机（如 OVH）、云服务器（如阿里云），还是框架集成（如 ThinkPHP）。不同场景下，SMTPAuth、SMTPSecure 和 Port 的组合逻辑完全不同，填错一个就卡在 SMTP connect() failed。
为什么 new PHPMailer(true) 后立刻报 SMTP connect() failed
这不是代码写错了，而是网络策略或认证方式不匹配。常见原因有：
- 在 OVH、SiteGround 等共享主机上，
smtp.gmail.com或smtp.qq.com被主动屏蔽，必须改用其官方中继（如ssl0.ovh.net） -
SMTPSecure值设为'tls'但端口用了465（应配'ssl'），或设为'ssl'却连了587（会握手失败） - Gmail 要求开启两步验证并生成「应用专用密码」，填邮箱登录密码必然失败；QQ/163 同理，必须用「授权码」而非账户密码
- 阿里云轻量服务器默认封禁 25/465/587 出站端口，需在控制台安全组放行，或改用阿里云邮件推送（
smtpdm.aliyun.com）
QQ 邮箱和 163 邮箱的 SMTP 参数差异
表面都是 smtp.qq.com 和 smtp.163.com，但实际兼容性细节差别很大：
- QQ 邮箱强制要求
SMTPSecure = 'ssl'+Port = 465；填587会返回530 Must issue a STARTTLS command first - 163 邮箱支持双模式：
Port = 465+SMTPSecure = 'ssl'，或Port = 587+SMTPSecure = 'tls'；但部分老旧服务器不支持 TLS，建议优先选 465/SSL - 两者都要求
Username是完整邮箱地址（如user@qq.com），不能只写用户名 -
setFrom()的邮箱必须与Username完全一致，否则 163 会拒绝发送（QQ 相对宽松）
ThinkPHP 或 Laravel 中怎么避免硬编码密码
把密码写死在代码里等于公开密钥。正确做法是抽离到环境变量或配置文件：
立即学习“PHP免费学习笔记（深入）”；
- ThinkPHP：在
config/mail.php中定义数组，'password' => env('MAIL_PASSWORD', '')，再在.env写MAIL_PASSWORD=xxxxxx - Laravel：直接用
config/mail.php的env('MAIL_PASSWORD')，无需额外引入 - 所有框架都应禁止将
vendor/或.env提交到 Git——检查.gitignore是否包含这两项 - 测试时可临时启用
$mail->SMTPDebug = 2，但上线前必须关掉，否则泄露 SMTP 凭据
附件发送失败或乱码的三个关键点
addAttachment() 看似简单，但路径、编码、内存限制三者任一出错都会静默失败：
- 路径必须是服务端真实绝对路径（如
/var/www/html/upload/file.pdf），不能是 URL 或相对路径 - 中文文件名需额外设置：
$mail->addAttachment($path, '订单发票_20260510.pdf', 'base64', 'application/pdf')，第 3 个参数指定编码，第 4 个指定 MIME 类型 - 大附件（>2MB）可能触发
memory_limit或upload_max_filesize限制，需同步调整 PHP 配置，或改用流式附件（addStringAttachment()）
最常被跳过的其实是域名验证——OVH、阿里云邮件推送、腾讯企业邮等，都要求发信域名已通过 MX 或 TXT 记录验证，否则即使连接成功，也会被收件方拒收或打入垃圾箱。别只盯着 PHPMailer 配置，DNS 和邮箱后台的验证状态得先确认清楚。
