如何使用Insphpect确保灵活，可重用的PHP代码。

它可以替代PHP mail()函数吗？

在大多数情况下，它是PHP mail()函数的替代方法，但是在许多其他情况下，该mail()函数的灵活性不足以实现所需的功能。

首先，PHPMailer提供了一个面向对象的接口，而mail()不是面向对象的。PHP开发人员通常不喜欢在$headers使用该mail()函数发送电子邮件时创建字符串，因为它们需要进行大量转义。PHPMailer使这变得轻而易举。使用该mail()功能时，开发人员还需要编写肮脏的代码（转义字符，编码和格式）以发送附件和基于HTML的电子邮件，而PHPMailer使此工作变得轻松。

此外，该mail()功能还要求本地邮件服务器发送电子邮件，而设置电子邮件并非总是如此。如果您具有身份验证，PHPMailer可以使用非本地邮件服务器（SMTP）。

其他优点包括：

• 如果无法发送电子邮件，它可以使用40多种语言打印各种错误消息。
• 它具有集成的SMTP协议支持以及基于SSL和TLS的身份验证。
• 它可以为非HTML电子邮件客户端发送电子邮件的替代纯文本版本。
• 它有一个非常活跃的开发人员社区，可确保其安全性和最新性。

流行的PHP内容管理系统（如WordPress，Drupal和Joomla）也使用PHPMailer。

安装PHPMailer

您可以使用Composer 安装PHPMailer：

composer require phpmailer/phpmailer

使用PHPMailer从本地Web服务器发送电子邮件

这是使用PHPMailer从本地Web服务器发送电子邮件的最简单示例：

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

require_once "vendor/autoload.php";

//PHPMailer Object
$mail = new PHPMailer(true); //Argument true in constructor enables exceptions

//From email address and name
$mail->From = "from@yourdomain.com";
$mail->FromName = "Full Name";

//To address and name
$mail->addAddress("recepient1@example.com", "Recepient Name");
$mail->addAddress("recepient1@example.com"); //Recipient name is optional

//Address to which recipient will reply
$mail->addReplyTo("reply@yourdomain.com", "Reply");

//CC and BCC
$mail->addCC("cc@example.com");
$mail->addBCC("bcc@example.com");

//Send HTML or Plain Text email
$mail->isHTML(true);

$mail->Subject = "Subject Text";
$mail->Body = "<i>Mail body in HTML</i>";
$mail->AltBody = "This is the plain text version of the email content";

try {
    $mail->send();
    echo "Message has been sent successfully";
} catch (Exception $e) {
    echo "Mailer Error: " . $mail->ErrorInfo;
}

代码和注释应该足够清楚，以解释正在发生的一切。

发送带有附件的电子邮件

这是一个如何使用PHPMailer发送带有附件的电子邮件的示例：

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

require_once "vendor/autoload.php";

$mail = new PHPMailer;

$mail->From = "from@yourdomain.com";
$mail->FromName = "Full Name";

$mail->addAddress("recipient1@example.com", "Recipient Name");

//Provide file path and name of the attachments
$mail->addAttachment("file.txt", "File.txt");        
$mail->addAttachment("images/profile.png"); //Filename is optional

$mail->isHTML(true);

$mail->Subject = "Subject Text";
$mail->Body = "<i>Mail body in HTML</i>";
$mail->AltBody = "This is the plain text version of the email content";

try {
    $mail->send();
    echo "Message has been sent successfully";
} catch (Exception $e) {
    echo "Mailer Error: " . $mail->ErrorInfo;
}

在这里，我们将附加两个文件- file.txt，与脚本位于同一目录，以及images/profile.png，位于images脚本目录的目录。

要将附件添加到电子邮件中，我们只需要addAttachment通过传递文件路径作为参数来调用PHPMailer对象的函数。要附加多个文件，我们需要多次调用它。

故障排除

在我们的两个示例中，我们使用PHPMailer的Exception类进行调试，因此抛出的任何错误将有助于我们调试可能发生的任何问题。我们还将参数添加true到PHPMailer构造函数中，以输出更高级别，更具描述性的异常。

根据我们使用的系统，我们可能会看到的最常见的错误可能与mail()在后台运行该函数有关：

Mailer错误：无法实例化邮件功能。

如果我们需要更多有关错误的详细信息，我们还可以在catch子句中添加以下内容：

print_r(error_get_last());

通常，邮件功能的问题与缺少的邮件服务器设置有关，在这种情况下，该error_get_last功能将返回如下内容：

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
)

这是我们可能最常遇到的问题，我们可以使用SMTP轻松解决它。

显示本地化的错误消息

$mail->ErrorInfo 可以返回43种不同语言的错误消息。

要以其他语言显示错误消息，请将language目录从PHPMailer的源代码复制到项目目录。

例如，要以俄语返回错误消息，请使用以下方法调用将PHPMailer对象设置为俄语：

$mail->setLanguage("ru");

您也可以将自己的语言文件添加到language目录中。

使用SMTP

您可以使用其他主机的邮件服务器发送电子邮件，但是为此，您首先需要进行身份验证。例如，要从Gmail的邮件服务器发送电子邮件，您需要具有一个Gmail帐户。

SMTP是邮件客户端用来将电子邮件发送请求发送到邮件服务器的协议。邮件服务器验证电子邮件后，会将其发送到目标邮件服务器。

这是从您的域的Gmail邮件服务器发送电子邮件的示例。您不需要本地邮件服务器即可运行代码。我们将使用SMTP协议：

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

require_once "vendor/autoload.php";

$mail = new PHPMailer(true);

//Enable SMTP debugging.
$mail->SMTPDebug = 3;                               
//Set PHPMailer to use SMTP.
$mail->isSMTP();            
//Set SMTP host name                          
$mail->Host = "smtp.gmail.com";
//Set this to true if SMTP host requires authentication to send email
$mail->SMTPAuth = true;                          
//Provide username and password     
$mail->Username = "name@gmail.com";                 
$mail->Password = "super_secret_password";                           
//If SMTP requires TLS encryption then set it
$mail->SMTPSecure = "tls";                           
//Set TCP port to connect to
$mail->Port = 587;                                   

$mail->From = "name@gmail.com";
$mail->FromName = "Full Name";

$mail->addAddress("name@example.com", "Recepient Name");

$mail->isHTML(true);

$mail->Subject = "Subject Text";
$mail->Body = "<i>Mail body in HTML</i>";
$mail->AltBody = "This is the plain text version of the email content";

try {
    $mail->send();
    echo "Message has been sent successfully";
} catch (Exception $e) {
    echo "Mailer Error: " . $mail->ErrorInfo;
}

Gmail需要通过SMTP进行TLS加密，因此我们进行了相应的设置。通过SMTP发送之前，您需要找出主机名，端口号，加密类型（如果需要），如果需要身份验证，则还需要用户名和密码。请注意，在Gmail上启用了双重身份验证后，您将无法通过用户名/密码使用其SMTP。相反，将需要其他配置。

通过本地邮件使用远程SMTP的一大优势是，如果您使用PHP的mail()功能发送from地址域设置为本地域名（服务器名称）以外的任何其他地址的电子邮件，则收件人的电子邮件服务器的攻击过滤器将对其进行标记作为垃圾邮件。例如，如果您从服务器发送一封电子邮件，其实际主机名example.com的from地址name@gmail.com为name@yahoo.com，则Yahoo的服务器会将其标记为垃圾邮件，或者向用户显示一条不信任该电子邮件的消息，因为该邮件的来源是该邮件example.com，但该邮件本身仍然存在好像来自gmail.com。尽管您name@gmail.com是Yahoo的拥有者，但Yahoo无法找到答案。

使用POP3检索电子邮件

PHPMailer还允许SMTP之前的POP验证发送电子邮件。换句话说，您可以使用POP进行身份验证并使用SMTP发送电子邮件。遗憾的是，PHPMailer不支持使用POP3协议从邮件服务器检索电子邮件。仅限于发送电子邮件。

结论

如果您是PHP开发人员，则几乎不必避免以编程方式发送电子邮件。尽管您可以选择使用Mandrill或SendGrid之类的第三方服务，但有时这不是一个选择，而滚动自己的电子邮件发送库的可能性甚至更低。那就是PHPMailer及其替代品（Zend Mail，Swift Mailer等）出现的地方。

您可以在存储库Wiki或官方文档中了解此库的API 。

您是否对PHP库依赖感到困惑？观看我们的截屏视频，了解Composer如何帮助您进行管理。