PHP发送电子邮件：使用PHPMailer - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

PHP 发邮件？别怕！PHPMailer 来拯救你！ (呕心沥血版)

各位观众老爷们！大家好！欢迎来到今天的“PHP发邮件不再愁”特别节目！我是你们的老朋友，人称bug终结者，代码界的段子手——码农李！（掌声在哪里？👏）

今天，咱们不聊那些高深的架构，不谈那些复杂的算法，就来聊聊一个看似简单，实则暗藏玄机的任务：PHP 发送电子邮件！

你可能会说：“发邮件？这还不简单？mail() 函数一把梭！” 少年，你太天真了！就像电影里的英雄，总是要经历九九八十一难才能抱得美人归一样，直接用 mail() 函数发邮件，你可能会遇到以下这些幺蛾子：

垃圾箱一日游： 邮件直接进垃圾箱，用户压根儿看不到，你的营销活动直接GG。
乱码横行： 明明写的是“你好世界”，收到的却是“????????”，简直是火星文！
服务器怒吼： 大量邮件发送，服务器直接崩溃，老板让你卷铺盖走人。

别慌！别怕！码农李今天就来教你一招，让你轻松搞定 PHP 发邮件，从此告别垃圾箱，告别乱码，告别服务器崩溃！我们的秘密武器就是：

PHPMailer！

PHPMailer 是个啥？

PHPMailer，简单来说，就是一个专门用来发送电子邮件的 PHP 类库。把它想象成一个专业的快递员，它会帮你把邮件打包好，贴好标签，然后安全可靠地送到收件人手中。它有以下这些优点：

功能强大： 支持 SMTP、Sendmail、Qmail 等多种发送方式，可以发送 HTML 邮件、附件、嵌入图片等等。
简单易用： 只需要几行代码，就能搞定复杂的邮件发送任务。
兼容性好： 支持各种 PHP 版本，各种操作系统。
安全可靠： 可以进行身份验证，防止邮件被篡改。
开源免费： 你可以随意使用，随意修改。

废话不多说，咱们直接上代码！

首先，你需要下载 PHPMailer 类库。你可以去 PHPMailer 的 GitHub 仓库 (https://github.com/PHPMailer/PHPMailer) 下载最新版本。下载完成后，解压到你的项目目录中。

接下来，创建一个 PHP 文件，例如 send_email.php，然后写入以下代码：

<?php

use PHPMailerPHPMailerPHPMailer;
use PHPMailerPHPMailerSMTP;
use PHPMailerPHPMailerException;

require 'path/to/PHPMailer/src/Exception.php';  // 替换成你的实际路径
require 'path/to/PHPMailer/src/PHPMailer.php';  // 替换成你的实际路径
require 'path/to/PHPMailer/src/SMTP.php';  // 替换成你的实际路径

// 创建 PHPMailer 对象
$mail = new PHPMailer(true);  // Passing `true` enables exceptions

try {
    // 服务器设置
    $mail->SMTPDebug = SMTP::DEBUG_SERVER;  // 启用详细的调试输出  (开发环境建议开启，生产环境建议关闭)
    $mail->isSMTP();                                            // 使用 SMTP 发送
    $mail->Host       = 'smtp.example.com';                     // SMTP 服务器地址  (替换成你的 SMTP 服务器地址)
    $mail->SMTPAuth   = true;                                   // 启用 SMTP 身份验证
    $mail->Username   = '[email protected]';                // SMTP 用户名  (替换成你的邮箱账号)
    $mail->Password   = 'your_password';                           // SMTP 密码  (替换成你的邮箱密码，如果是授权码，也填在这里)
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;         // 启用 TLS 加密， `PHPMailer::ENCRYPTION_SMTPS` 启用 SSL 加密
    $mail->Port       = 587;                                    // TCP 端口，如果是 SSL 加密，通常是 465

    // 收件人
    $mail->setFrom('[email protected]', '你的名字');  // 发件人邮箱和发件人姓名
    $mail->addAddress('[email protected]', '收件人姓名');     // 收件人邮箱和收件人姓名
    $mail->addAddress('[email protected]');               // 可选的收件人
    $mail->addReplyTo('[email protected]', '信息');          // 回复地址
    // $mail->addCC('[email protected]');                            // 抄送
    // $mail->addBCC('[email protected]');                           // 密送

    // 附件
    // $mail->addAttachment('/var/tmp/file.tar.gz');         // 添加附件
    // $mail->addAttachment('/tmp/image.jpg', 'new.jpg');    // 可选的附件名称

    // 内容
    $mail->isHTML(true);                                  // 设置邮件格式为 HTML
    $mail->Subject = '这是一封测试邮件';
    $mail->Body    = '<h1>欢迎来到 PHPMailer 的世界！</h1><p>这是一封使用 PHPMailer 发送的测试邮件。</p>';
    $mail->AltBody = '这是一封使用 PHPMailer 发送的纯文本测试邮件。';  // 如果客户端不支持 HTML，则显示此内容

    $mail->send();
    echo '邮件发送成功！';
} catch (Exception $e) {
    echo "邮件发送失败: {$mail->ErrorInfo}";
}

?>

代码解释：

引入 PHPMailer 类库：

use PHPMailerPHPMailerPHPMailer;
use PHPMailerPHPMailerSMTP;
use PHPMailerPHPMailerException;

require 'path/to/PHPMailer/src/Exception.php';  // 替换成你的实际路径
require 'path/to/PHPMailer/src/PHPMailer.php';  // 替换成你的实际路径
require 'path/to/PHPMailer/src/SMTP.php';  // 替换成你的实际路径

这段代码的作用是引入 PHPMailer 类库，让你的 PHP 文件可以使用 PHPMailer 的功能。 path/to/PHPMailer 要替换成你实际的 PHPMailer 类库的路径。 记住，一定要替换！ 不然你的代码会报错，就像你考试忘记带笔一样，直接懵逼！ 😱

创建 PHPMailer 对象：
```
$mail = new PHPMailer(true);  // Passing `true` enables exceptions
```
这行代码创建了一个 PHPMailer 对象，true 表示启用异常处理。如果发送邮件过程中出现错误，PHPMailer 会抛出一个异常，方便你进行调试。

服务器设置：

$mail->SMTPDebug = SMTP::DEBUG_SERVER;  // 启用详细的调试输出  (开发环境建议开启，生产环境建议关闭)
$mail->isSMTP();                                            // 使用 SMTP 发送
$mail->Host       = 'smtp.example.com';                     // SMTP 服务器地址  (替换成你的 SMTP 服务器地址)
$mail->SMTPAuth   = true;                                   // 启用 SMTP 身份验证
$mail->Username   = '[email protected]';                // SMTP 用户名  (替换成你的邮箱账号)
$mail->Password   = 'your_password';                           // SMTP 密码  (替换成你的邮箱密码，如果是授权码，也填在这里)
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;         // 启用 TLS 加密， `PHPMailer::ENCRYPTION_SMTPS` 启用 SSL 加密
$mail->Port       = 587;                                    // TCP 端口，如果是 SSL 加密，通常是 465

这段代码是设置 SMTP 服务器的信息。 你需要根据你使用的邮箱服务商提供的信息进行修改。 例如，如果你使用 Gmail，你需要设置以下信息：

Host: smtp.gmail.com
Username: 你的 Gmail 邮箱账号
Password: 你的 Gmail 邮箱密码 (或者授权码，建议使用授权码)
SMTPSecure: PHPMailer::ENCRYPTION_STARTTLS (或者 PHPMailer::ENCRYPTION_SMTPS)
Port: 587 (如果使用 PHPMailer::ENCRYPTION_SMTPS，则为 465)

注意： Gmail 可能需要你开启“允许不太安全的应用访问” (Less secure app access) 或者使用“应用专用密码” (App Passwords)。为了安全起见，强烈建议你使用应用专用密码。

参数	描述
`SMTPDebug`	调试模式。 `SMTP::DEBUG_OFF` (关闭), `SMTP::DEBUG_CLIENT` (显示客户端消息), `SMTP::DEBUG_SERVER` (显示客户端和服务器消息), `SMTP::DEBUG_CONNECTION` (显示连接信息), `SMTP::DEBUG_LOWLEVEL` (显示所有信息)
`isSMTP()`	使用 SMTP 发送邮件。
`Host`	SMTP 服务器地址。
`SMTPAuth`	启用 SMTP 身份验证。
`Username`	SMTP 用户名。
`Password`	SMTP 密码 (或者授权码)。
`SMTPSecure`	加密方式。`PHPMailer::ENCRYPTION_STARTTLS` (TLS 加密), `PHPMailer::ENCRYPTION_SMTPS` (SSL 加密)
`Port`	TCP 端口。

收件人：
```
$mail->setFrom('[email protected]', '你的名字');  // 发件人邮箱和发件人姓名
$mail->addAddress('[email protected]', '收件人姓名');     // 收件人邮箱和收件人姓名
$mail->addAddress('[email protected]');               // 可选的收件人
$mail->addReplyTo('[email protected]', '信息');          // 回复地址
// $mail->addCC('[email protected]');                            // 抄送
// $mail->addBCC('[email protected]');                           // 密送
```
这段代码是设置邮件的收件人、发件人、回复地址、抄送和密送。 你需要替换成你实际的邮箱地址和姓名。
- setFrom(): 设置发件人邮箱和发件人姓名。
- addAddress(): 添加收件人邮箱和收件人姓名。你可以添加多个收件人。
- addReplyTo(): 设置回复地址。如果收件人回复邮件，邮件会发送到这个地址。
- addCC(): 添加抄送。抄送人会收到邮件的副本。
- addBCC(): 添加密送。密送人会收到邮件的副本，但是其他收件人看不到密送人的地址。
附件：
```
// $mail->addAttachment('/var/tmp/file.tar.gz');         // 添加附件
// $mail->addAttachment('/tmp/image.jpg', 'new.jpg');    // 可选的附件名称
```
这段代码是添加附件。 你需要替换成你实际的附件路径和名称。
- addAttachment(): 添加附件。第一个参数是附件的路径，第二个参数是可选的附件名称。

内容：

$mail->isHTML(true);                                  // 设置邮件格式为 HTML
$mail->Subject = '这是一封测试邮件';
$mail->Body    = '<h1>欢迎来到 PHPMailer 的世界！</h1><p>这是一封使用 PHPMailer 发送的测试邮件。</p>';
$mail->AltBody = '这是一封使用 PHPMailer 发送的纯文本测试邮件。';  // 如果客户端不支持 HTML，则显示此内容

这段代码是设置邮件的内容。

isHTML(true): 设置邮件格式为 HTML。你可以使用 HTML 标签来格式化邮件内容。
Subject: 设置邮件主题。
Body: 设置邮件正文。如果 isHTML(true)，则可以使用 HTML 标签。
AltBody: 设置纯文本邮件正文。如果客户端不支持 HTML，则显示此内容。

发送邮件：
```
$mail->send();
echo '邮件发送成功！';
```
这段代码是发送邮件。
- send(): 发送邮件。如果发送成功，返回 true，否则返回 false。
- echo '邮件发送成功！';: 如果发送成功，则输出“邮件发送成功！”。
异常处理：
```
} catch (Exception $e) {
    echo "邮件发送失败: {$mail->ErrorInfo}";
}
```
这段代码是异常处理。如果发送邮件过程中出现错误，PHPMailer 会抛出一个异常，这段代码会捕获这个异常，并输出错误信息。

运行代码：

将 send_email.php 文件放到你的 Web 服务器的目录下，然后在浏览器中访问这个文件。如果一切顺利，你应该会看到“邮件发送成功！”的提示。然后，去你的收件箱里看看，是不是收到了一封来自 PHPMailer 的测试邮件。 🎉

常见问题：

邮件发送失败，提示“SMTP 错误”：
- 检查你的 SMTP 服务器地址、用户名、密码、加密方式和端口是否正确。
- 检查你的邮箱服务商是否需要开启“允许不太安全的应用访问”或者使用“应用专用密码”。
- 检查你的服务器是否允许连接 SMTP 服务器。有些服务器可能禁止连接外部 SMTP 服务器。
邮件进入垃圾箱：
- 检查你的邮件内容是否包含敏感词汇，例如“广告”、“促销”、“免费”等。
- 检查你的邮件服务器是否被列入黑名单。
- 建议使用 SPF、DKIM 和 DMARC 等技术来提高邮件的可信度。
乱码：
- 确保你的 PHP 文件和邮件内容都使用 UTF-8 编码。
- 在设置邮件头部时，指定 Content-Type 为 text/html; charset=UTF-8。 PHPMailer 已经帮你做了，所以一般不需要手动设置。
附件无法下载：
- 检查你的附件路径是否正确。
- 检查你的附件文件是否损坏。
- 检查你的 Web 服务器是否允许下载附件。

进阶技巧：

使用 HTML 模板： 你可以将邮件内容放到 HTML 模板中，然后使用 PHPMailer 将模板渲染成 HTML 邮件。这样可以方便你修改邮件内容，而不需要修改 PHP 代码。
使用队列发送邮件： 如果需要发送大量邮件，建议使用队列来发送邮件。这样可以避免服务器崩溃，并提高邮件发送的效率。你可以使用 Redis、RabbitMQ 等消息队列来实现邮件队列。
记录邮件发送日志： 建议记录邮件发送日志，方便你排查问题，并统计邮件发送情况。

总结：

PHPMailer 是一个功能强大、简单易用的 PHP 类库，可以帮助你轻松搞定 PHP 发邮件。掌握 PHPMailer 的使用方法，可以让你告别垃圾箱，告别乱码，告别服务器崩溃！希望今天的节目对你有所帮助！

作业：

使用 PHPMailer 发送一封包含附件的邮件。
使用 HTML 模板发送一封格式精美的邮件。
了解 SPF、DKIM 和 DMARC 等技术，并尝试配置你的邮件服务器。

好了，今天的节目就到这里。感谢大家的观看！我们下期再见！ (鞠躬) 😊

PHP 发邮件？别怕！PHPMailer 来拯救你！ (呕心沥血版)

发表回复 取消回复

发表回复取消回复