與phpmailer一起發送PHP中的電子郵件

PHPMailer：PHP郵件發送的利器

PHPMailer是廣受歡迎的開源PHP郵件發送庫，自2001年發布以來，一直是PHP開發者發送程序化郵件的首選方案之一，與Swiftmailer等其他流行庫並駕齊驅。本文將闡述為何PHPMailer優於PHP內置的mail()函數，並提供代碼示例。

核心要點

• PHPMailer是一個流行的開源PHP郵件發送庫，比PHP內置的mail()函數提供更多功能和靈活性，包括面向對象的接口、更輕鬆的HTML和附件處理，以及使用非本地郵件服務器的能力。
• PHPMailer可以使用Composer安裝，並被WordPress、Drupal和Joomla等流行的PHP內容管理系統使用。
• 該庫提供強大的錯誤處理機制，能夠以40多種語言打印錯誤消息，並集成了SMTP協議支持以及SSL和TLS身份驗證。
• 除了發送郵件，PHPMailer還支持添加附件、發送HTML或純文本版本的郵件，以及使用SMTP從非本地服務器發送郵件，但它不支持使用POP3協議從郵件服務器檢索郵件。

PHPMailer與PHP mail()函數的比較

在大多數情況下，PHPMailer是PHP內置mail()函數的替代方案，但在許多情況下，mail()函數的靈活性不足以滿足需求。

首先，PHPMailer提供面向對象的接口，而mail()函數不是面向對象的。 PHP開發者通常不喜歡使用mail()函數發送郵件時創建$headers字符串，因為這需要大量的轉義操作。 PHPMailer簡化了這個過程。使用mail()函數發送附件和基於HTML的郵件時，開發者還需要編寫複雜的代碼（轉義字符、編碼和格式化），而PHPMailer使這變得輕鬆自如。

此外，mail()函數需要本地郵件服務器才能發送郵件，這並不總是容易設置的。如果具備身份驗證功能，PHPMailer可以使用非本地郵件服務器（SMTP）。

其他優勢包括：

• 發送郵件失敗時，它可以用40多種語言打印各種錯誤消息。
• 它集成了SMTP協議支持以及SSL和TLS身份驗證。
• 它可以為非HTML郵件客戶端發送郵件的替代純文本版本。
• 它擁有一個非常活躍的開發者社區，使其保持安全和最新狀態。

PHPMailer也被WordPress、Drupal和Joomla等流行的PHP內容管理系統使用。

安裝PHPMailer

可以使用Composer安裝PHPMailer：

composer require phpmailer/phpmailer

使用PHPMailer從本地Web服務器發送郵件

以下是使用PHPMailer從本地Web服務器發送郵件的最簡單示例：

composer require phpmailer/phpmailer

PHP文件中的代碼和註釋應該足夠清晰地解釋所有正在發生的事情；您可以看到我們在其中設置郵件主題、發件人電子郵件地址、收件人電子郵件地址、HTML郵件正文以及處理錯誤的地方。

發送包含附件的郵件

以下是如何使用PHPMailer發送包含附件的郵件的示例：

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

require_once "vendor/autoload.php";

// PHPMailer对象
$mail = new PHPMailer(true); // 构造函数中的参数true启用异常

// 发件人邮箱地址和名称
$mail->From = "from@yourdomain.com";
$mail->FromName = "完整姓名";

// 收件人地址和名称
$mail->addAddress("recepient1@example.com", "收件人姓名");
$mail->addAddress("recepient1@example.com"); // 收件人姓名是可选的

// 收件人回复地址
$mail->addReplyTo("reply@yourdomain.com", "回复");

// 抄送和密送
$mail->addCC("cc@example.com");
$mail->addBCC("bcc@example.com");

// 发送HTML或纯文本邮件
$mail->isHTML(true);

$mail->Subject = "主题文本";
$mail->Body = "<i>HTML格式邮件正文</i>";
$mail->AltBody = "这是邮件内容的纯文本版本";

try {
    $mail->send();
    echo "邮件已成功发送";
} catch (Exception $e) {
    echo "邮件错误：" . $mail->ErrorInfo;
}
?>

在這裡，我們附加了兩個文件——file.txt（位於與腳本相同的目錄中）和images/profile.png（位於腳本目錄的images目錄中）。

要向郵件添加附件，我們只需通過將文件路徑作為參數傳遞來調用PHPMailer對象的addAttachment函數。要附加多個文件，我們需要多次調用它。

故障排除

在我們的兩個示例中，我們使用了PHPMailer的Exception類進行調試，因此拋出的任何錯誤都將幫助我們調試可能發生的任何問題。我們還在PHPMailer構造函數中添加了參數true，以輸出更高級別、更具描述性的異常。

根據我們使用的系統，我們可能看到的最大錯誤將與在後台運行mail()函數有關：

郵件錯誤：無法實例化郵件函數。

如果我們需要更詳細的錯誤信息，我們還可以向catch子句添加如下內容：

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

require_once "vendor/autoload.php";

$mail = new PHPMailer;

$mail->From = "from@yourdomain.com";
$mail->FromName = "完整姓名";

$mail->addAddress("recipient1@example.com", "收件人姓名");

// 提供附件的文件路径和名称
$mail->addAttachment("file.txt", "File.txt");
$mail->addAttachment("images/profile.png"); // 文件名是可选的

$mail->isHTML(true);

$mail->Subject = "主题文本";
$mail->Body = "<i>HTML格式邮件正文</i>";
$mail->AltBody = "这是邮件内容的纯文本版本";

try {
    $mail->send();
    echo "邮件已成功发送";
} catch (Exception $e) {
    echo "邮件错误：" . $mail->ErrorInfo;
}
?>

通常，郵件函數的問題將與缺少郵件服務器設置有關，在這種情況下，error_get_last函數將返回類似以下內容：

print_r(error_get_last());

這可能是我們最常遇到的問題，我們可以通過使用SMTP輕鬆解決它。

顯示本地化錯誤消息

$mail->ErrorInfo可以返回43種不同語言的錯誤消息。

要以不同的語言顯示錯誤消息，請將語言目錄從PHPMailer的源代碼複製到項目目錄。

例如，要以俄語返回錯誤消息，請使用以下方法調用將PHPMailer對象設置為俄語：

<code>Array (
    [type] => 2
    [message] => mail(): Failed to connect to mailserver at "localhost" port 25, verify your "SMTP" and "smtp_port" setting in php.ini or use ini_set()
    [file] => OUR_PATH \vendor\phpmailer\phpmailer\src\PHPMailer.php
    [line] => 863
)</code>

您還可以將自己的語言文件添加到語言目錄。

使用SMTP

您可以使用另一個主機的郵件服務器發送郵件，但這首先需要身份驗證。例如，要從Gmail的郵件服務器發送郵件，您需要有一個Gmail帳戶。

SMTP是郵件客戶端用於向郵件服務器發送郵件發送請求的協議。郵件服務器驗證郵件後，將其發送到目標郵件服務器。

以下是從您的域發送來自Gmail郵件服務器的郵件的示例。您不需要本地服務器來運行代碼。我們將使用SMTP協議：

composer require phpmailer/phpmailer

Gmail需要通過SMTP進行TLS加密，因此我們相應地進行了設置。在通過SMTP發送之前，您需要找出主機名、端口號、是否需要加密類型以及如果需要身份驗證，還需要用戶名和密碼。請注意，在Gmail上啟用雙因素身份驗證將不允許您使用用戶名/密碼使用其SMTP。相反，需要額外的配置。

使用遠程SMTP而不是本地郵件的一大優勢是，如果您使用PHP的mail()函數發送郵件，並將發件人地址域設置為與本地域名（服務器名稱）不同的任何內容，則收件人的電子郵件服務器的攻擊過濾器會將其標記為垃圾郵件。例如，如果您從主機名為example.com的服務器使用發件人地址name@gmail.com向name@yahoo.com發送郵件，則雅虎的服務器會將其標記為垃圾郵件，或向用戶顯示一條消息，指示不要信任該郵件，因為郵件的來源是example.com，但它卻顯示為來自gmail.com。儘管您擁有name@gmail.com，但雅虎無法知道這一點。

使用POP3檢索郵件

PHPMailer還允許POP-before-SMTP驗證來發送郵件。換句話說，您可以使用POP進行身份驗證，並使用SMTP發送郵件。遺憾的是，PHPMailer不支持使用POP3協議從郵件服務器檢索郵件。它僅限於發送郵件。

結論

如果您是PHP開發者，幾乎不可能避免以編程方式發送郵件。雖然您可以選擇Mandrill或SendGrid等第三方服務，但有時這根本不可行，而自己編寫郵件發送庫更是如此。這就是PHPMailer及其替代方案（Zend Mail、Swift Mailer等）的用武之地。

您可以在存儲庫wiki或官方文檔中了解有關此庫的API。

您是否因為PHP庫依賴關係而苦惱？觀看我們的屏幕錄像，了解Composer如何幫助您管理它。

關於PHPMailer的常見問題

什麼是PHPMailer？ PHPMailer是一個流行的開源PHP庫，用於從PHP應用程序發送電子郵件。它提供了一種簡單靈活的方式來通過SMTP、mail()或其他電子郵件發送方法發送電子郵件。

如何安裝PHPMailer？您可以使用Composer安裝PHPMailer，也可以直接從GitHub下載該庫。詳細的安裝說明可以在PHPMailer文檔中找到。

PHPMailer是否免費使用？是的，PHPMailer是開源的，並根據LGPL許可證發布，這意味著它可以在開源和商業項目中免費使用。

PHPMailer的系統要求是什麼？ PHPMailer與PHP 5.5及更高版本兼容。確保您的Web託管環境支持這些PHP版本。

如何使用PHPMailer發送電子郵件？您可以通過創建PHPMailer類的實例、設置必要的屬性（如SMTP服務器詳細信息和電子郵件內容），然後調用send()方法來使用PHPMailer發送電子郵件。

PHPMailer能否處理電子郵件中的附件？是的，PHPMailer提供方法來向您的電子郵件添加附件。您可以附加來自服務器或遠程位置的文件。

什麼是SMTP，為什麼我應該將其與PHPMailer一起使用？ SMTP（簡單郵件傳輸協議）是發送電子郵件的常用方法。將SMTP與PHPMailer一起使用允許您通過遠程電子郵件服務器發送電子郵件，從而為電子郵件傳遞提供更好的控制和可靠性。

我可以用PHPMailer發送HTML電子郵件嗎？

是的，PHPMailer允許您發送純文本和HTML格式的電子郵件。您可以相應地設置消息類型和格式。純文本電子郵件適用於非HTML郵件客戶端。

我可以使用PHPmailer向非HTML郵件客戶端發送純文本電子郵件嗎？

是的，PHPMailer允許您發送純文本電子郵件作為HTML電子郵件的替代方案。您可以相應地設置消息類型和格式。純文本電子郵件適用於非HTML郵件客戶端。

我可以將PHPMailer與非SMTP郵件服務器（如Sendmail）一起使用嗎？是的，PHPMailer支持各種電子郵件傳輸方法，包括SMTP、mail()和其他自定義方法，允許您將其與不同類型的郵件服務器一起使用。

以上是與phpmailer一起發送PHP中的電子郵件的詳細內容。更多資訊請關注PHP中文網其他相關文章！