如何正确配置 PHPMailer 连接 Gmail SMTP 发送邮件-php教程-PHP中文网

如何正确配置 PHPMailer 连接 Gmail SMTP 发送邮件

本文详解 phpmailer 连接 gmail smtp 失败（“could not connect to smtp host”）的常见原因与修复方案，涵盖加密方式、端口、认证设置及安全配置要点，助你快速实现稳定邮件发送。

本文详解 phpmailer 连接 gmail smtp 失败（“could not connect to smtp host”）的常见原因与修复方案，涵盖加密方式、端口、认证设置及安全配置要点，助你快速实现稳定邮件发送。

PHPMailer 无法连接 Gmail SMTP 服务器，是开发者在集成邮件功能时高频遇到的问题。错误提示 SMTP Error: Could not connect to SMTP host 表面看是网络问题，实则绝大多数源于协议配置不匹配——尤其是 SMTPSecure 和 Port 的组合错误。

Gmail 官方明确支持两种 SMTP 安全模式：

TLS 模式：使用 SMTPSecure = 'tls' + Port = 587（推荐，现代标准，STARTTLS 升级明文连接）
SSL 模式：使用 SMTPSecure = 'ssl' + Port = 465（仍可用，但属隐式 SSL，已逐步被 TLS 取代）

⚠️ 注意：你原代码中写的是 $mail->SMTPSecure = 'ssl';encryption —— 这是语法错误：'ssl';encryption 是非法字符串，会导致配置失效；且 Gmail 对 ssl://465 的兼容性在新版 PHPMailer（v6.8+）和较新 PHP 环境中可能因 OpenSSL 配置或防火墙策略而中断。强烈建议统一采用 TLS + 587 方案。

此外，$mail->Mailer = 'smtp' 虽在较新版本中非强制（isSMTP() 已隐式设定），但显式声明可提升代码可读性与向后兼容性，避免意外回退到 mail() 函数。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

✅ 正确配置片段如下（已修正全部关键点）：

<?php use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'PHPMailer/src/Exception.php';
require 'PHPMailer/src/PHPMailer.php';
require 'PHPMailer/src/SMTP.php';

$mail = new PHPMailer(true);

try {
    $mail->isSMTP();
    $mail->Mailer     = 'smtp';          // 显式指定 SMTP 传输器
    $mail->Host       = 'smtp.gmail.com';
    $mail->SMTPAuth   = true;
    $mail->Username   = 'yourname@gmail.com'; // ✅ 必须是完整邮箱格式（非 'mymail.com'）
    $mail->Password   = 'your-app-password';  // ✅ 使用 Google 应用专用密码（非账户密码！）
    $mail->SMTPSecure = 'tls';                // ✅ 固定为 'tls'
    $mail->Port       = 587;                 // ✅ 对应 tls 的标准端口

    $mail->setFrom('yourname@gmail.com', 'Dev4');
    $mail->addAddress('recipient@example.com');
    $mail->addReplyTo('noreply@gmail.com', 'Information');

    $mail->isHTML(true);
    $mail->Subject = 'Here is the subject';
    $mail->Body    = 'This is the HTML message body <b>in bold!</b>';
    $mail->AltBody = 'This is the plain-text fallback';

    $mail->send();
    echo 'Message has been sent successfully!';
} catch (Exception $e) {
    echo "Message could not be sent. Mailer Error: {$mail->ErrorInfo}";
}

? 关键注意事项：

Gmail 账户必须启用两步验证，并在 Google 账户 → 安全 → 应用专用密码中生成 16 位密码（Password 字段填此密码，绝不可用登录密码）；
Username 必须是完整邮箱地址（如 dev4@gmail.com），而非用户名或域名；
确保服务器允许出站连接至 smtp.gmail.com:587（部分共享主机或企业防火墙会屏蔽该端口）；
若仍失败，可在 try 块前添加 $mail->SMTPDebug = 2; 启用调试日志，查看握手过程细节；
推荐使用 Composer 安装 PHPMailer（composer require phpmailer/phpmailer），避免手动引入路径错误与版本混乱。

遵循以上配置，99% 的 Gmail SMTP 连接问题将迎刃而解。记住：协议、端口、认证凭据三者必须严格匹配 Gmail 当前要求——稳定不是偶然，而是精准配置的结果。