与phpmailer一起发送PHP中的电子邮件-php教程-PHP中文网

PHPMailer：PHP邮件发送的利器

PHPMailer是广受欢迎的开源PHP邮件发送库，自2001年发布以来，一直是PHP开发者发送程序化邮件的首选方案之一，与Swiftmailer等其他流行库并驾齐驱。本文将阐述为何PHPMailer优于PHP内置的mail()函数，并提供代码示例。

Sending Emails in PHP with PHPMailer

核心要点

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，但雅虎无法知道这一点。