ECShop 內建的 cls_smtp 類別在透過 SMTP 發送郵件時,常因 fgets() 讀取伺服器回應超時,導致 get_data() 方法失敗;註釋該行卻又引發 EHLO command failed 錯誤。雖然連線實際已建立,但原生實作對異常網路環境容錯極差。本文提供以 PHPMailer 替換核心發信邏輯的完整方案,徹底解決超時、認證失敗與編碼亂碼問題。
cls_smtp::get_data() 使用阻塞式 fgets($conn, 512) 讀取回應,無超時重試機制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;
}
$mail->ErrorInfo 提供詳細 SMTP 交互日誌,排錯極簡單includes/phpmailer/ 目錄smtp_mail() 函式覆蓋 includes/lib_base.php 或對應核心檔案中的同名函式| 現象 | 可能原因 | 解決方式 |
|---|---|---|
| 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'; 且資料庫/頁面編碼一致 |
替換為 PHPMailer 後,ECShop 發信穩定性將獲得質的飛躍。建議同步升級至 PHP 7.4+ 並啟用 OPcache,進一步提升整體效能。