composer安装phpmailer无需手动配置autoload，但发信失败主因是smtp凭据错误、未启用smtpauth或云服务器端口被封；需正确设置host、port、smtpsecure及应用专用密码。
Composer 安装 PHPMailer 不需要手动下载或配置 autoload，但直接 require 后仍发不出邮件，大概率是没配对 SMTP 凭据、没启用 SMTPAuth，或被服务商限制了非网页端登录。
用 composer require 安装 PHPMailer
在项目根目录执行命令即可，PHPMailer 已迁移到 phpmailer/phpmailer 包名（旧的 phpmailer/phpmailer 重定向至此，但建议写全）：
composer require phpmailer/phpmailer
安装后自动注册到 Composer 的 autoloader，无需额外 require 文件。只要确保你的脚本已引入 vendor/autoload.php：
require 'vendor/autoload.php';
常见错误：安装成功但运行报 Class 'PHPMailer\PHPMailer\PHPMailer' not found，说明没加载 autoload，或用了错的命名空间（注意大小写和反斜杠）。
立即学习“PHP免费学习笔记（深入）”；
初始化 PHPMailer 并启用 SMTP 认证
PHPMailer 默认用 mail() 函数发送，该方式在大多数 Linux 服务器上被禁用或不可靠。必须显式切换为 SMTP 模式，并开启认证：
-
$mail->isSMTP()是必需调用，否则不走 SMTP -
$mail->SMTPAuth = true必须设为true，否则 Gmail、QQ 邮箱等一律拒绝连接 -
$mail->SMTPSecure = 'tls'或'ssl'，Gmail 推荐tls（端口 587），QQ 邮箱也支持tls；ssl对应端口 465，部分环境兼容性差 -
$mail->Port = 587必须与SMTPSecure匹配，不能写成465却设tls
示例最小可用配置（以 Gmail 为例）：
use PHPMailer\PHPMailer\PHPMailer; use PHPMailer\PHPMailer\SMTP; $mail = new PHPMailer(true); $mail->isSMTP(); $mail->Host = 'smtp.gmail.com'; $mail->SMTPAuth = true; $mail->Username = 'your@gmail.com'; $mail->Password = 'your-app-password'; // 注意：不是邮箱登录密码，是 Google 账户生成的「应用专用密码」 $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS; $mail->Port = 587;
QQ 邮箱 / 163 邮箱的特殊配置点
国内常用邮箱对 SMTP 限制更严，容易卡在连接或认证环节：
- QQ 邮箱必须在「设置 → 账户 → POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务」中开启「SMTP服务」，并获取「POP3/SMTP服务」授权码（不是 QQ 密码）
- 163 邮箱同理，需开启「SMTP服务」，授权码独立于登录密码，且需绑定手机
- Host 地址别写错：
smtp.qq.com（QQ）、smtp.163.com（163），注意没有 www - 163 要求
SMTPSecure = 'ssl'+Port = 465，或'tls'+587；QQ 邮箱两者都支持，但推荐tls+587 - 发件人地址（
$mail->setFrom()）必须与Username一致，否则 163/QQ 会拒信
调试失败时优先检查这三项
发信失败不报错？或报 SMTP connect() failed？先确认：
- 是否调用了
$mail->SMTPDebug = SMTP::DEBUG_SERVER？没开调试就等于闭眼排障 - 是否启用了
$mail->SMTPOptions绕过 OpenSSL 验证（仅开发环境临时用）：$mail->SMTPOptions = [ 'ssl' => ['verify_peer' => false, 'verify_peer_name' => false, 'allow_self_signed' => true] ]; - 是否在云服务器（如阿里云、腾讯云）上运行？它们默认屏蔽 25/465/587 端口出方向，需提交工单解封或改用 API 邮件服务
PHPMailer 报错信息藏在 $mail->ErrorInfo 里，打印它比猜快十倍；而最常被忽略的是——应用专用密码要从对应邮箱账户后台生成，复制粘贴时末尾空格、全角字符都会导致认证失败。
