萬盛學電腦網

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

PHPMailer 實戰指南:基於 SMTP 發送郵件(Gmail/163 實戰配置)

PHPMailer 郵件發送完整教程:從安裝到生產級配置

PHP 內置 mail() 功能受限,無法滿足現代應用對 HTML 郵件、附件、SMTP 認證、併發發送等需求。PHPMailer 是業界標準解決方案,本文提供基於 Gmail 和 163 郵箱的完整配置實戰。

環境準備

  • PHP 5.5+ / 7.x / 8.x
  • Composer 安裝:composer require phpmailer/phpmailer
  • 或手動下載:GitHub 官方倉庫
  • 啟用 PHP 擴展:openssl、sockets

Gmail SMTP 配置(SSL 模式)

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

require 'vendor/autoload.php';

$mail = new PHPMailer(true); // true 啟用異常模式

try {
    // SMTP 服務器設置
    $mail->isSMTP();
    $mail->Host       = 'smtp.gmail.com';
    $mail->SMTPAuth   = true;
    $mail->Username   = 'your_email@gmail.com';
    $mail->Password   = 'your_app_password'; // 應用專用密碼,非登錄密碼
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS; // SSL
    $mail->Port       = 465;
    
    // 發件人設置
    $mail->setFrom('your_email@gmail.com', '系統名稱');
    
    // 收件人
    $mail->addAddress('recipient@example.com', '收件人姓名');
    $mail->addReplyTo('reply@example.com', '回復地址');
    
    // 附件
    $mail->addAttachment('/path/to/file.pdf');
    $mail->addAttachment('/path/to/image.jpg', 'rename.jpg'); // 重命名
    
    // 郵件內容
    $mail->isHTML(true);
    $mail->Subject = 'PHPMailer 測試郵件';
    $mail->Body    = '

HTML 內容

支持圖片、鏈接、樣式...

'; $mail->AltBody = '純文本備選內容(不支持 HTML 的客戶端)'; $mail->send(); echo '郵件發送成功'; } catch (Exception $e) { echo "發送失敗: {$mail->ErrorInfo}"; } ?>

163 郵箱配置(TLS 模式)

<?php
// 僅展示差異配置
$mail->Host       = 'smtp.163.com';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS; // TLS
$mail->Port       = 465; // 或 587/994
$mail->Username   = 'your_account@163.com';
$mail->Password   = 'client_auth_password'; // 客戶端授權碼,非登錄密碼
?>

關鍵配置差異對比

配置項Gmail163/網易QQ 郵箱
SMTP 服務器smtp.gmail.comsmtp.163.comsmtp.qq.com
加密方式SSL (465)SSL (465/994) / TLS (587)SSL (465/587)
認證方式應用專用密碼客戶端授權碼授權碼
發件人限制需驗證域名需綁定域名需驗證域名

生產環境優化建議

  1. 異步發送:將郵件推入隊列(Redis/RabbitMQ),Worker 後台發送,避免阻塞主進程
  2. 模板引擎:集成 Twig/Blade 分離郵件模板與業務邏輯
  3. 發送限流:遵守郵件服務商頻率限制,實現指數退避重試
  4. 退信處理:配置郵件回調(Webhook)處理 Bounce/Complaint
  5. DKIM/SPF/DMARC:配置域名解析記錄提升送達率
  6. 批量發送:使用 addBCC() 隱藏收件人列表,單次連接發送多封

常見問題排查

  • 連接超時:檢查防火牆、安全組、VPC 網絡策略,確保 465/587 端口通暢
  • 認證失敗:確認使用授權碼而非登錄密碼,檢查郵箱開啟 SMTP 服務
  • 進垃圾箱:完善 SPF/DKIM/DMARC,優化內容質量,避免敏感詞
  • 中文亂碼:設置 $mail->CharSet = 'UTF-8',確保文件編碼為 UTF-8
copyright © 萬盛學電腦網 all rights reserved