PHPMailer 是 PHP 中非常流行的邮件发送库，它支持多种邮件发送方式，包括 SMTP、PHP 内置的 mail() 函数、以及通过 Gmail、Outlook 等第三方邮件服务发送邮件。PHPMailer 提供了丰富的功能，包括设置邮件主题、内容、附件、HTML 格式等，并且能够处理常见的邮件发送错误。

以下是使用 PHPMailer 配置发送邮件的详细方法。

1. 安装 PHPMailer

PHPMailer 可以通过 Composer 安装，Composer 是 PHP 的包管理工具。首先确保你已经安装了 Composer。如果没有安装 Composer，可以访问 Composer官网 进行安装。

通过 Composer 安装

在项目根目录下运行以下命令：

composer require phpmailer/phpmailer

此命令会自动下载并安装 PHPMailer 库，并生成 vendor 文件夹。如果你没有使用 Composer，也可以从 GitHub 下载 PHPMailer 的源代码并手动引入。

2. 引入 PHPMailer

安装完成后，你需要在 PHP 文件中引入 PHPMailer 库。通过 Composer 安装时，你可以直接引入 vendor/autoload.php，该文件会自动加载所有通过 Composer 安装的库。

// 引入 Composer 自动加载器
require 'vendor/autoload.php';

如果没有使用 Composer，你可以手动引入 PHPMailer 的类文件。

// 手动引入 PHPMailer 类文件
require 'PHPMailer/PHPMailerAutoload.php';

3. 基本的邮件发送配置

下面是一个简单的示例，展示如何通过 PHPMailer 配置并发送邮件：

<?php
// 引入 PHPMailer
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php'; // 使用 Composer 自动加载

$mail = new PHPMailer(true);  // 创建 PHPMailer 实例

try {
    // 服务器设置
    $mail->isSMTP();  // 使用 SMTP
    $mail->Host = 'smtp.gmail.com';  // SMTP 服务器地址（Gmail 示例）
    $mail->SMTPAuth = true;  // 开启 SMTP 认证
    $mail->Username = 'your_email@gmail.com';  // SMTP 用户名（发送邮件的邮箱）
    $mail->Password = 'your_email_password';  // SMTP 密码（你的邮箱密码）
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;  // 启用 TLS 加密
    $mail->Port = 587;  // SMTP 端口（常见的 SMTP 端口为 587）

    // 发件人设置
    $mail->setFrom('your_email@gmail.com', 'Your Name');  // 设置发件人
    $mail->addAddress('recipient@example.com', 'Recipient Name');  // 设置收件人

    // 邮件内容
    $mail->isHTML(true);  // 设置邮件格式为 HTML
    $mail->Subject = 'PHPMailer 测试邮件';  // 邮件主题
    $mail->Body    = '这是一个通过 <b>PHPMailer</b> 发送的邮件！';  // 邮件正文（支持 HTML）

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

代码解析：

  1. SMTP 设置：
    • $mail->isSMTP()：使用 SMTP 协议发送邮件。
    • $mail->Host：指定 SMTP 服务器的地址（例如，Gmail 的 SMTP 服务器为 smtp.gmail.com）。
    • $mail->SMTPAuth：启用 SMTP 身份验证。
    • $mail->Username 和 $mail->Password：你的邮箱的 SMTP 用户名和密码。
    • $mail->SMTPSecure：设置 SMTP 安全连接方式。常见的值有 PHPMailer::ENCRYPTION_STARTTLS 或 PHPMailer::ENCRYPTION_SMTPS。
    • $mail->Port：SMTP 端口。常见端口为 587（对于 TLS）或 465（对于 SSL）。
  2. 发件人和收件人设置：
    • $mail->setFrom()：设置发件人的邮箱地址和名称。
    • $mail->addAddress()：设置收件人的邮箱地址和名称。如果有多个收件人，可以调用此函数多次。
  3. 邮件内容：
    • $mail->isHTML(true)：将邮件格式设置为 HTML，支持 HTML 格式的邮件正文。
    • $mail->Subject：设置邮件的主题。
    • $mail->Body：设置邮件正文，支持 HTML。
  4. 发送邮件：
    • $mail->send()：发送邮件。如果成功，会输出 “邮件已发送”；否则，会捕获异常并输出错误信息。

4. 使用 Gmail 发送邮件（应用密码）

如果你使用 Gmail 发送邮件，强烈建议使用 应用密码 来提高安全性，而不是直接使用 Gmail 账户的密码。Google 为账户启用了双重身份验证的用户提供了应用密码。可以在 Google 账户页面 生成一个应用密码。

5. 配置附件（可选）

PHPMailer 还支持添加附件。在邮件中附加文件非常简单：

// 添加附件
$mail->addAttachment('/path/to/file.txt');  // 添加文件
// 或者附加多个文件
$mail->addAttachment('/path/to/image.jpg', 'new_name.jpg');  // 第二个参数是附件的名称（可选）

6. 调试模式

为了方便调试，你可以开启 PHPMailer 的调试模式，这样会打印出 SMTP 服务器的响应，帮助你更好地调试邮件发送问题：

$mail->SMTPDebug = 2;  // 开启调试模式，输出详细调试信息（0：关闭调试，1：客户端，2：客户端和服务器）
$mail->Debugoutput = 'html';  // 输出格式

7. 发送 HTML 邮件和文本邮件

除了发送 HTML 格式的邮件外，你还可以发送纯文本邮件，或者同时发送 HTML 和纯文本邮件：

// 发送纯文本邮件
$mail->isHTML(false);
$mail->Body = '这是纯文本邮件内容';

// 发送 HTML 和纯文本邮件（MIME 格式）
$mail->AltBody = '这是纯文本版本的邮件内容';
$mail->isHTML(true);
$mail->Body = '这是 <b>HTML</b> 格式的邮件内容';

8. 常见问题及解决方法

  1. SMTP 错误：
    • 如果遇到 SMTP Error: Could not connect to SMTP host，请检查你使用的 SMTP 主机、端口号和加密协议是否正确。
    • 如果你使用 Gmail，确保启用了 低安全应用访问 或使用 应用密码。
  2. 邮件发送失败：
    • 如果邮件发送失败并返回错误信息，检查 PHP 错误日志，查看详细的错误信息。
    • 也可以通过设置 $mail->SMTPDebug = 2 获取更多的调试信息。
  3. 防火墙问题：
    • 一些服务器可能阻止外部的 SMTP 连接。确保防火墙允许访问 SMTP 服务端口（例如 587 或 465）。

9. 总结

使用 PHPMailer 发送邮件非常简单且强大，可以通过配置 SMTP 服务器、添加附件、设置 HTML 格式内容等方式轻松定制邮件内容。通过调试模式，你可以轻松诊断和解决邮件发送中的问题。

  • 使用 Composer 安装 PHPMailer，避免手动管理库文件。
  • 配置发件人、收件人、主题、正文等内容。
  • 通过 addAttachment() 方法添加附件。
  • 启用调试模式帮助诊断邮件发送问题。

这样，你就可以通过 PHPMailer 在 PHP 中轻松实现邮件发送功能了！