TP5中用Composer安装PHPMailer最稳妥，但90%失败源于autoload未引入、命名空间错误、SMTP参数错配或服务商策略变更；Class 'PHPMailerPHPMailerPHPMailer' not found实为自动加载链断裂，需检查vendor/autoload.php路径、完整命名空间use PHPMailerPHPMailerPHPMailer及composer dump-autoload刷新。
直接说结论：TP5 项目里用 Composer 安装 PHPMailer 是最稳的路径，但“装上就发得出去”基本不存在——90% 的失败发生在 vendor/autoload.php 没引入、命名空间写错、SMTP 参数配反、或服务商端口/认证策略变更这四点上。
Class 'PHPMailerPHPMailerPHPMailer' not found 怎么快速定位
这不是没装，是自动加载链断了或命名空间漏字。常见表现是执行 composer require phpmailer/phpmailer 后，new PHPMailer() 报错。
- 确认入口文件（如
public/index.php）里写了require __DIR__ . '/../vendor/autoload.php';，且路径没错（别用../vendor/autoload.php这种相对路径在子目录下跑） - 类必须用完整命名空间：
use PHPMailerPHPMailerPHPMailer;，不是use PHPMailer;，也不是use PHPMailerPHPMailer;（少一层） - 检查
vendor/composer/autoload_psr4.php里有没有这行：'PHPMailer\PHPMailer\' => array($vendorDir . '/phpmailer/phpmailer/src') - IDE 缓存旧 autoloader？运行
composer dump-autoload -o强制刷新
TP5 中调用 PHPMailer 发不出邮件的典型配置坑
TP5 本身不带邮件组件，靠 Composer 加载后手动封装。很多 TP5 教程示例用的是过时写法（比如 $mail->IsSMTP()），实际运行会静默失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
$mail->isSMTP()必须在setFrom()之前调用，否则退化为系统mail()函数（多数服务器禁用） -
$mail->SMTPSecure和$mail->Port必须严格匹配：'tls'+587，或'ssl'+465；Gmail 现在只认PHPMailer::ENCRYPTION_STARTTLS（对应'tls'），'ssl'+465在某些 PHP 版本会握手失败 - 发件人邮箱（
setFrom()）必须和Username完全一致，QQ 邮箱、163、腾讯企业邮都校验这个 - 密码字段填的是「应用专用密码」，不是登录密码；Gmail/Outlook 必须开两步验证后生成，163/126 要在设置里开启 SMTP 并获取授权码
TP5 封装 send_mail() 函数时容易忽略的细节
很多人把 PHPMailer 实例塞进 common.php 或助手函数里复用，结果发第二封就失败或内存暴涨。
- 每次发信必须新建实例：
$mail = new PHPMailerPHPMailerPHPMailer(true);，别全局单例或静态复用 - 附件只传绝对路径：
$mail->addAttachment('/var/www/app/runtime/log/error.log');，别传 URL 或相对路径（file_get_contents会反复尝试读取失败） - 中文主题/正文乱码？不是
CharSet没设，而是$mail->isHTML(true)要在$mail->Body赋值前调用；Subject用$mail->Subject = mb_encode_mimeheader('测试标题', 'UTF-8')更稳妥 - 调试别只看
send()返回值：设$mail->SMTPDebug = 2，错误信息直接打到 stdout，能看见535 Authentication failed这类关键响应
最麻烦的永远不是装包，是 SMTP 服务端策略在变——上周还通的 smtp.qq.com:587，这周可能因 IP 段被限而超时；Gmail 的 ENCRYPTION_SMTPS 已标记废弃，硬写会连不上。动手前先用 openssl s_client -connect smtp.qq.com:587 -starttls smtp 测通不通，比改十遍代码有用。
