ThinkPHP5邮件如何发送_ThinkPHP5SMTP邮件发送配置【扩展】

先说几个核心判断：ThinkPHP5 下用 PHPMailer 发邮件，本身不是什么高深操作。但如果你直接 new PHPMailer() 就撞上 Class not found，那八成是踩了框架自动加载的坑。这里不绕弯子——90% 的失败都集中在三个环节：类加载失败、SMTP 配置写错、以及各种“看似没问题就是发不出”的细节翻车。

为什么 new PHPMailer() 会报 Class not found？

根因在于 ThinkPHP5 的 extend/ 目录只认小写命名且要求明确命名空间。你用 composer require phpmailer/phpmailer 装好后，vendor/ 下的类路径是大写字母开头的（比如 PHPMailerPHPMailerPHPMailer），框架压根不认这个路径。

解决办法其实很干脆：放弃 Composer 自带的安装方式，手动处理。具体来说：

• 删掉 vendor/phpmailer/phpmailer
• 下载 PHPMailer v6.9+ 源码，只取出 src/PHPMailer.php、src/SMTP.php、src/Exception.php 这三个核心文件
• 全部重命名为小写，放进 extend/phpmailer/ 目录下，也就是 phpmailer.php、smtp.php、exception.php
• 每个文件第一行加上 namespace phpmailer;——这一步最容易漏，漏了之后 use phpmailerphpmailer; 照样报错

SMTP 配置项哪些不能写错？

配置本身不复杂，但四个字段写错一个就连接超时或认证拒绝。163 和 QQ 邮箱是重灾区：

• host：163 填 smtp.163.com，QQ 填 smtp.qq.com。别写成 mail.163.com，也别漏掉 smtp. 前缀
• port：SSL 模式下必须是 465，不是 994 也不是 25；TLS 模式才用 587
• smtp_secure：值只能是字符串 'ssl' 或 'tls'，不能大写，也不能写成布尔值。填 'SSL' 会静默失效，不报错但发不出
• password：这里最容易翻车——必须是「客户端授权码」，不是邮箱登录密码。163 的授权码在「设置 → POP3/SMTP/IMAP → 客户端授权码」里生成，QQ 类似

附件发不出、中文乱码、Debug 不出错怎么办？

话说回来，很多场景下代码逻辑没问题，邮件也能“发送成功”，但就是没附件、主题显示问号、$mail->ErrorInfo 为空。这种时候别急着改代码，先排查环境细节：

• 附件路径必须用绝对路径，且文件名用英文。/var/www/html/runtime/mail/notice.pdf 没问题，/var/www/html/运行日志.pdf 大概率失败
• 中文乱码的根源是 CharSet 和 Subject 编码不一致。统一设为 utf-8 后，再用 $mail->Subject = mb_encode_mimeheader($subject, 'UTF-8', 'B'); 处理主题头
• Debug 没输出？检查 SMTPDebug 是否设为 2（不是 1 或 true），同时把 Debugoutput 设为 'html' 或 'echo'，否则错误信息只写日志不显示
• OpenSSL 扩展必须启用。在 phpinfo() 里查一下 openssl 是否已加载，没启用的话 SMTPSecure = 'ssl' 会直接跳过加密握手

真正卡住人的从来不是“怎么写”，而是路径权限不对、授权码输错一次就被锁、配置键名大小写混用、附件用了相对路径却没 chdir()——这些细节不亲手验证一遍，光看文档永远发不出第一封邮件。