PHPMailer：PHP郵件發(fā)送的利器

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

核心要點

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

PHPMailer與PHP mail()函數(shù)的比較

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

首先，PHPMailer提供面向?qū)ο蟮慕涌冢?code>mail()函數(shù)不是面向?qū)ο蟮摹?PHP開發(fā)者通常不喜歡使用mail()函數(shù)發(fā)送郵件時創(chuàng)建$headers字符串，因為這需要大量的轉(zhuǎn)義操作。 PHPMailer簡化了這個過程。使用mail()函數(shù)發(fā)送附件和基於HTML的郵件時，開發(fā)者還需要編寫複雜的代碼（轉(zhuǎn)義字符、編碼和格式化），而PHPMailer使這變得輕鬆自如。

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

其他優(yōu)勢包括：

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

PHPMailer也被WordPress、Drupal和Joomla等流行的PHP內(nèi)容管理系統(tǒng)使用。

安裝PHPMailer

可以使用Composer安裝PHPMailer：

composer require phpmailer/phpmailer

使用PHPMailer從本地Web服務器發(fā)送郵件

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

composer require phpmailer/phpmailer

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

發(fā)送包含附件的郵件

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

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

require_once "vendor/autoload.php";

// PHPMailer對象
$mail = new PHPMailer(true); // 構(gòu)造函數(shù)中的參數(shù)true啟用異常

// 發(fā)件人郵箱地址和名稱
$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");

// 發(fā)送HTML或純文本郵件
$mail->isHTML(true);

$mail->Subject = "主題文本";
$mail->Body = "<i>HTML格式郵件正文</i>";
$mail->AltBody = "這是郵件內(nèi)容的純文本版本";

try {
    $mail->send();
    echo "郵件已成功發(fā)送";
} catch (Exception $e) {
    echo "郵件錯誤：" . $mail->ErrorInfo;
}
?>

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

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

故障排除

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

根據(jù)我們使用的系統(tǒng)，我們可能看到的最大錯誤將與在後臺運行mail()函數(shù)有關(guān)：

郵件錯誤：無法實例化郵件函數(shù)。

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

<?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 = "這是郵件內(nèi)容的純文本版本";

try {
    $mail->send();
    echo "郵件已成功發(fā)送";
} catch (Exception $e) {
    echo "郵件錯誤：" . $mail->ErrorInfo;
}
?>

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

print_r(error_get_last());

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

顯示本地化錯誤消息

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

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

例如，要以俄語返回錯誤消息，請使用以下方法調(diào)用將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

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

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

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

composer require phpmailer/phpmailer

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

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

使用POP3檢索郵件

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

結(jié)論

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

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

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

關(guān)於PHPMailer的常見問題

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

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

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

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

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

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

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

我可以用PHPMailer發(fā)送HTML電子郵件嗎？

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

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

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

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

以上是與phpmailer一起發(fā)送PHP中的電子郵件的詳細內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！