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，或用了错的命名空间（注意大小写和反斜杠）。

初始化 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 里，打印它比猜快十倍；而最常被忽略的是——应用专用密码要从对应邮箱账户后台生成，复制粘贴时末尾空格、全角字符都会导致认证失败。