萬盛學電腦網

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

ECShop SMTP 發信失效?改用 PHPMailer 完美解決發送超時與 EHLO 錯誤

ECShop 內建的 cls_smtp 類別在透過 SMTP 發送郵件時,常因 fgets() 讀取伺服器回應超時,導致 get_data() 方法失敗;註釋該行卻又引發 EHLO command failed 錯誤。雖然連線實際已建立,但原生實作對異常網路環境容錯極差。本文提供以 PHPMailer 替換核心發信邏輯的完整方案,徹底解決超時、認證失敗與編碼亂碼問題。

問題根因分析

  • cls_smtp::get_data() 使用阻塞式 fgets($conn, 512) 讀取回應,無超時重試機制
  • 部分 SMTP 伺服器(如 Gmail、企業郵箱)要求 TLS/SSL 加密,原生類別支援不完善
  • 中文編碼轉換邏輯耦合在核心類別,難以維護

解決方案:整合 PHPMailer 替換 smtp_mail() 函式

PHPMailer 是成熟、活躍維護的郵件發送庫,支援 SMTP/TLS/SSL、HTML/純文本、附件、內嵌圖片、多語系編碼等企業級功能。

完整替換代碼

function smtp_mail($name, $email, $subject, $content, $type = 1, $notification = false) {
    // 編碼轉換:若系統編碼非郵件編碼,統一轉換
    if ($GLOBALS['_CFG']['mail_charset'] != EC_CHARSET) {
        $name      = ecs_iconv(EC_CHARSET, $GLOBALS['_CFG']['mail_charset'], $name);
        $subject   = ecs_iconv(EC_CHARSET, $GLOBALS['_CFG']['mail_charset'], $subject);
        $content   = ecs_iconv(EC_CHARSET, $GLOBALS['_CFG']['mail_charset'], $content);
        $shop_name = ecs_iconv(EC_CHARSET, $GLOBALS['_CFG']['mail_charset'], $GLOBALS['_CFG']['shop_name']);
    }
    $charset = $GLOBALS['_CFG']['mail_charset'];

    include_once ROOT_PATH . 'includes/phpmailer/class.phpmailer.php';
    $mail = new PHPMailer();

    // 寄件人設定
    $mail->From       = $GLOBALS['_CFG']['smtp_user'];
    $mail->FromName   = '您的公司名稱'; // 建議從後台設定讀取

    // 郵件傳輸模式選擇
    if ($GLOBALS['_CFG']['mail_service'] == 0) {
        $mail->isMail(); // 使用 PHP mail() 函式
    } else {
        $mail->IsSMTP();
        $mail->Host       = $GLOBALS['_CFG']['smtp_host'];
        $mail->Port       = $GLOBALS['_CFG']['smtp_port'];
        $mail->SMTPAuth   = !empty($GLOBALS['_CFG']['smtp_pass']);
        $mail->Username   = $GLOBALS['_CFG']['smtp_user'];
        $mail->Password   = $GLOBALS['_CFG']['smtp_pass'];
        // 若需 SSL/TLS,取消下行註解並確認 Port (通常 465/587)
        // $mail->SMTPSecure = 'ssl'; // 或 'tls'
    }

    // 郵件內容設定
    $mail->Encoding     = 'base64';
    $mail->CharSet      = $charset;
    $mail->IsHTML($type);
    $mail->Subject      = $subject;
    $mail->Body         = $content;
    $mail->Timeout      = 30; // 連線超時秒數
    $mail->SMTPDebug    = false; // 除錯時設為 2 或 true

    // 收件人
    $mail->ClearAddresses();
    $mail->AddAddress($email, $name);
    $mail->ConfirmReadingTo = $notification;

    // 發送與錯誤處理
    if (!$mail->Send()) {
        $GLOBALS['err']->add($mail->ErrorInfo);
        $GLOBALS['err']->add($GLOBALS['_LANG']['sendemail_false']);
        return false;
    }
    return true;
}

關鍵優勢說明

  1. 自動協商加密:支援 STARTTLS、SMTPS,無需手動處理握手流程
  2. 完善的錯誤資訊:$mail->ErrorInfo 提供詳細 SMTP 交互日誌,排錯極簡單
  3. 編碼自動處理:Base64/Quoted-Printable 自動選擇,中文主旨與內容零亂碼
  4. 相容性極佳:相容所有主流 SMTP 服務(Gmail、Outlook、SendGrid、阿里雲郵件推送等)

部署步驟

  1. 下載 PHPMailer 最新版,解壓至 includes/phpmailer/ 目錄
  2. 將上述 smtp_mail() 函式覆蓋 includes/lib_base.php 或對應核心檔案中的同名函式
  3. 後台「郵件服務器設定」正確填寫 SMTP 主機、埠號、帳號、密碼
  4. 測試發送註冊驗證信、訂單通知信,確認收件箱正常接收

常見坑位與排查

現象可能原因解決方式
Connection timeout防火牆封鎖埠號、埠號錯誤、主機名拼寫錯誤telnet 測試連通性、確認 25/465/587 埠開放
Authentication failed帳號密碼錯誤、SMTP 服務未啟用、需應用程式專用密碼登入郵箱網頁版開啟 SMTP、生成專用密碼
SSL certificate verify failed本地 CA 憑證過期、自簽憑證暫時關閉驗證 $mail->SMTPOptions = ['ssl' => ['verify_peer' => false, 'verify_peer_name' => false]]; (僅測試用)
中文亂碼CharSet 未設定或與內容編碼不符確保 $mail->CharSet = 'UTF-8'; 且資料庫/頁面編碼一致

進階擴充建議

  • 實作發信佇列(Redis + Worker)實現非同步發送,提升前端回應速度
  • 整合 DKIM/SPF/DMARC 簽名,提高郵件送達率
  • 加入發信日誌記錄(資料庫/檔案),便於審計與失敗重試
  • 支援多語系郵件模板,分離業務邏輯與內容呈現

替換為 PHPMailer 後,ECShop 發信穩定性將獲得質的飛躍。建議同步升級至 PHP 7.4+ 並啟用 OPcache,進一步提升整體效能。

copyright © 萬盛學電腦網 all rights reserved