XAMPP运行PHPMailer配置本地SSL/TLS证书发送安全邮件

XAMPP 在本地运行顺畅，但使用 PHPMailer 发送邮件时，`SMTP connect() failed` 错误频繁出现。问题根源并非密码或端口配置错误，而是 OpenSSL 在 TLS 握手阶段无法获取本地 CA 证书来验证远程服务器的合法性。这一现象在 Windows 平台上尤为常见，即使已经配置了 `openssl.cafile`，如果路径不正确或证书未下载，连接虽然能建立，但 TLS 协商会直接失败。

XAMPP 中 PHPMailer TLS 握手失败的常见原因

PHPMailer 调用 OpenSSL 建立连接时，会主动校验 SMTP 服务器（如 `smtp.gmail.com`）返回的证书是否由可信 CA 签发。XAMPP 自带的 PHP 环境默认不包含完整的 CA 证书包（`cacert.pem`），且 `php.ini` 中的 `openssl.cafile` 参数要么被注释，要么指向一个不存在的路径。因此，端口虽能连通，但进入 TLS 握手流程后验证失败，`send()` 直接抛出超时或空错误。 日志中通常会显示 `SMTP connect() failed` 并伴随 `stream_socket_enable_crypto(): SSL operation failed` 提示。这说明密码和端口配置无误，问题在于本地 PHP 缺少用于验证对方身份的证书。此外，即便 Windows 下启用了 `extension=openssl`，也不代表能自动获得可用的 CA 包；Linux 或 macOS 上的 MAMP/XAMPP 也会遇到类似情况。`curl` 可能正常工作，但 PHP 的 OpenSSL 却因为证书路径独立而无法通过。

手动指定 cacert.pem 让 PHPMailer 验证外部 SMTP 证书

最直接的解决方案是下载权威 CA 包，并显式告知 PHP 使用它。XAMPP 作为隔离环境，不依赖系统自带证书，因此必须手动操作。 具体步骤如下： - 下载最新的 `cacert.pem`，保存为 `C:\xampp\php\extras\ssl\cacert.pem`（路径可根据需要调整，但须前后一致）。 - 编辑 `C:\xampp\php\php.ini`，找到 `openssl.cafile` 这一行，取消注释并改为 `openssl.cafile="C:\xampp\php\extras\ssl\cacert.pem"`。 - 重启 Apache 服务，然后在命令行执行 `php -r "print_r(openssl_get_cert_locations());"`，确认输出中的 `default_cert_file` 指向刚才设置的路径。 - 至此，PHPMailer 端无需额外代码改动。只要 PHP 级别的证书路径正确，`$mail->SMTPSecure = 'tls'` 或 `'ssl'` 即可顺利执行。

OVH 主机等受限环境：跳过证书验证（仅限调试）

某些托管环境（如 OVH 共享主机）可能底层屏蔽了证书下载，或对 OpenSSL 设置了额外限制，导致常规证书方案失效。此时强制跳过验证可以快速确认逻辑是否正确，但仅适用于本地调试或临时测试，生产环境严禁使用。 操作方式：在 PHPMailer 初始化之后、`send()` 之前添加以下配置： ``` $mail->SMTPOptions = [ 'ssl' => [ 'verify_peer' => false, 'verify_peer_name' => false, 'allow_self_signed' => true ] ]; ``` 这段配置会绕过所有证书校验，仅建立 TLS 加密通道，但完全放弃身份真实性验证。如果在本地 XAMPP 测试时连不上 `ssl0.ovh.net:465`，可先添加此配置确认是否为证书问题；确认后必须立即删除，恢复为正式证书方案。注意：`verify_peer_name = false` 必须与 `verify_peer = false` 同时设置，否则 PHP 7.4 及以上版本会报 warning 并拒绝连接。

本地开发环境无需复杂证书配置

在本地 XAMPP 场景下，无需生成自签名证书、配置 Nginx/Apache SSL 或折腾 Let's Encrypt。目标只是让 PHP 能验证远端 SMTP 服务器的证书，而不是让浏览器信任 localhost。核心要点始终只有一个：确保 `openssl.cafile` 指向真实有效的 CA 包，且路径中不含中文、空格或过长字符（Windows 对此尤其敏感）。许多“配置检查了无数遍但无法发送”的案例，最终发现只是 `cacert.pem` 被放在桌面，而 `php.ini` 中写入了包含中文的路径——PHP 解析失败后静默回退到无证书状态，导致从头白费功夫。