PHPMailer 无法连接到 SMTP 主机：故障排除指南-php教程-PHP中文网

PHPMailer 无法连接到 SMTP 主机：故障排除指南

聖光之護

发布： 2025-08-22 19:08:12

原创

731人浏览过

phpmailer 无法连接到 smtp 主机：故障排除指南

PHPMailer 无法连接到 SMTP 主机：故障排除指南

正如摘要中提到的，PHPMailer 突然无法连接到 SMTP 主机的问题，通常与服务器对旧 TLS 版本的支持有关。这意味着，即使您的 PHPMailer 配置之前一直工作正常，服务器端的更改也可能导致连接失败。

问题分析

根本原因在于，出于安全考虑，许多邮件服务提供商（例如 Microsoft Outlook/Office365）正在逐步停止支持较旧的 TLS 协议版本。如果您的 PHP 环境依赖于这些过时的协议，那么与 SMTP 服务器的连接将无法建立。错误信息 "SMTP Error: Could not connect to SMTP host." 就是这一问题的直接体现。

解决方案：更新 PHP 版本

解决此问题的最有效方法是更新您的 PHP 版本。较新的 PHP 版本通常包含对最新 TLS 协议的支持，从而能够与邮件服务器建立安全的连接。

步骤：

立即学习“PHP免费学习笔记（深入）”；

检查当前 PHP 版本： 首先，确定您当前正在使用的 PHP 版本。可以通过在命令行中运行 php -v 命令或在 PHP 代码中使用 phpversion() 函数来查看。
```
<?php
echo '当前 PHP 版本：' . phpversion();
?>
```
登录后复制
更新 PHP： 根据您的服务器环境，选择合适的 PHP 更新方式。

无涯·问知
无涯·问知，是一款基于星环大模型底座，结合个人知识库、企业知识库、法律法规、财经等多种知识源的企业级垂直领域问答产品

40

查看详情
- Linux 服务器 (apt, yum 等)： 使用包管理器更新 PHP。例如，在 Ubuntu/Debian 上，可以使用 sudo apt update && sudo apt upgrade php 命令。
- Windows 服务器 (XAMPP, WAMP 等)： 下载并安装最新版本的 XAMPP 或 WAMP，其中包含了较新的 PHP 版本。
- 共享主机： 联系您的主机提供商，请求他们升级 PHP 版本。
验证更新： 更新完成后，再次使用 php -v 或 phpversion() 函数验证 PHP 版本是否已成功更新。

代码示例与配置

以下是一个使用 PHPMailer 连接到 Office365 的示例代码，请确保根据您的实际情况修改配置：

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

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

$mail = new PHPMailer(true);

try {
    //服务器配置
    $mail->CharSet = "UTF-8";
    $mail->SMTPDebug = 0;                      // 启用详细调试输出
    $mail->isSMTP();                                            // 使用 SMTP 发送
    $mail->Host       = 'smtp.office365.com';                     // 设置 SMTP 服务器
    $mail->SMTPAuth   = true;                                   // 启用 SMTP 身份验证
    $mail->Username   = 'your_email@example.com';                     // SMTP 用户名
    $mail->Password   = 'your_password';                               // SMTP 密码
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;         // 启用 TLS 加密，`ssl` 也可接受
    $mail->Port       = 587;                                    // TCP 端口

    // 发件人和收件人
    $mail->setFrom('your_email@example.com', 'Your Name');
    $mail->addAddress('recipient@example.com', 'Recipient Name');     // 添加收件人

    // 内容
    $mail->isHTML(true);                                  // 设置邮件格式为 HTML
    $mail->Subject = '邮件主题';
    $mail->Body    = '邮件正文内容';
    $mail->AltBody = '如果不支持 HTML 的客户端显示的纯文本内容';

    $mail->send();
    echo '邮件已发送';
} catch (Exception $e) {
    echo "邮件发送失败: {$mail->ErrorInfo}";
}

登录后复制

注意事项：