composer怎么安装PHPMailer发送邮件_composer引入邮件库与配置流程【教程】

苏承栈

2026-09-19 • 👁 0人浏览过

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 模式，并开启认证：阿里云AI平台阿里云AI平台下载

$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

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

相关文章