PHPMailer 核心屬性與方法中文參考手冊（基於 5.2 版本）

簡介

PHPMailer 是 PHP 發送郵件的標準庫，支持 SMTP、HTML、附件、嵌入圖片、多語言錯誤信息等。本文整理其核心類 PHPMailer 及 SMTP 的常用屬性與方法，供快速查閱。

PHPMailer 類核心屬性

PHPMailer 常用方法

SMTP 類核心方法（底層）

典型使用模板

<?php
require 'PHPMailerAutoload.php'; // 或 composer autoload

$mail = new PHPMailer(true); // true 開啟異常模式
try {
    $mail->isSMTP();
    $mail->Host = 'smtp.exmail.qq.com';
    $mail->Port = 465;
    $mail->SMTPAuth = true;
    $mail->Username = 'sender@domain.com';
    $mail->Password = 'password';
    $mail->SMTPSecure = 'ssl'; // 或 'tls' (587 端口)
    $mail->CharSet = 'UTF-8';
    $mail->setFrom('sender@domain.com', '發件人名稱');
    $mail->addAddress('recipient@example.com', '收件人');
    $mail->addReplyTo('reply@domain.com', '回復地址');
    $mail->isHTML(true);
    $mail->Subject = '測試郵件';
    $mail->Body = '<h1>HTML 內容</h1><p>支持中文</p>';
    $mail->AltBody = '純文本備用內容';
    // $mail->addAttachment('/path/to/file.pdf');
    // $mail->addEmbeddedImage('/path/to/logo.png', 'logo_id');
    $mail->send();
    echo '發送成功';
} catch (Exception $e) {
    echo "發送失敗: {$mail->ErrorInfo}";
}
?>

常見問題提示

• 中文亂碼：必須設置 $mail->CharSet = 'UTF-8'; 且文件保存為 UTF-8 無 BOM。
• SSL 證書驗證失敗：本地測試可暫時關閉 $mail->SMTPOptions = ['ssl' => ['verify_peer' => false, 'verify_peer_name' => false]];，生產環境請配置正確 CA 證書。
• 大附件發送超時：增加 $mail->Timeout，分片發送或使用雲郵件服務（SendGrid、Mailgun、阿里云郵件推送）。
• 批量發送：開啟 $mail->SMTPKeepAlive = true;，循環調用 addAddress/send/clearAddresses，最後 SmtpClose()。