萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHPMailer 發送 Gmail 郵件:SMTP 連接失敗排查全紀錄

問題現象

使用 PHPMailer 5.2.1 通過 Gmail SMTP 發送郵件,報錯:SMTP Error: Could not connect to SMTP host。

代碼配置

$mail = new PHPMailer();
$mail->IsSMTP();
$mail->SMTPDebug = 2;
$mail->SMTPAuth = true;
$mail->SMTPSecure = "ssl";
$mail->Host = "smtp.gmail.com";
$mail->Port = 465;
$mail->Username = "yourusername@gmail.com";
$mail->Password = "yourpassword";
$mail->SetFrom('name@yourdomain.com', 'First Last');
$mail->AddReplyTo("name@yourdomain.com","First Last");
$mail->Subject = "PHPMailer Test Subject via smtp (Gmail), basic";
$mail->AltBody = "To view the message, please use an HTML compatible email viewer!";
$mail->MsgHTML($body);
$mail->AddAddress("whoto@otherdomain.com", "John Doe");
$mail->AddAttachment("images/phpmailer.gif");
$mail->AddAttachment("images/phpmailer_mini.gif");
if(!$mail->Send()) {
    echo "Mailer Error: " . $mail->ErrorInfo;
} else {
    echo "Message sent!";
}

根因分析

PHP 未啟用 OpenSSL 擴展,導致無法建立 SSL/TLS 加密連接。

解決方案

  1. 打開 php.ini,找到 ;extension=php_openssl.dll,去掉前面的分號。
  2. 重啟 Web 服務器(Apache/Nginx + PHP-FPM)。
  3. 驗證:php -m | grep openssl 或 phpinfo() 中查看 OpenSSL 支持。

補充:Gmail 現代安全設置

若開啟 OpenSSL 後仍失敗,請檢查:

  • 兩步驗證:需生成「應用專用密碼」替代登錄密碼。
  • 低安全性應用:舊版設置已棄用,請改用應用專用密碼或 OAuth2。
  • 端口替代:嘗試 SMTPSecure = 'tls', Port = 587。
  • 防火牆/雲服務商限制:確保出站 465/587 端口通暢。

完善後的配置模板

$mail = new PHPMailer(true); // 啟用異常拋出
try {
    $mail->isSMTP();
    $mail->Host       = 'smtp.gmail.com';
    $mail->SMTPAuth   = true;
    $mail->Username   = 'your@gmail.com';
    $mail->Password   = 'your_app_password'; // 應用專用密碼
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS; // ssl
    $mail->Port       = 465;

    $mail->setFrom('your@gmail.com', 'Your Name');
    $mail->addAddress('to@example.com', 'Recipient');
    $mail->isHTML(true);
    $mail->Subject = '測試郵件';
    $mail->Body    = '這是 HTML 內容';
    $mail->AltBody = '這是純文本內容';

    $mail->send();
    echo '發送成功';
} catch (Exception $e) {
    echo "發送失敗: {$mail->ErrorInfo}";
}
copyright © 萬盛學電腦網 all rights reserved