PHP邮件库使用教程及安装指南

PHPMailer 是一个功能强大且广泛使用的 PHP 邮件发送库，支持 SMTP 认证、HTML 邮件、附件等多种特性。如果你需要在 PHP 项目中实现邮件发送功能，安装和使用 PHPMailer 是一个高效的选择。

1. 安装 PHPMailer（推荐使用 Composer）

Composer 是 PHP 的依赖管理工具，使用它可以轻松安装和管理 PHPMailer。

打开终端或命令行工具，在项目根目录下执行以下命令：

• 如果没有 composer.json 文件，先初始化：

composer init

• 安装 PHPMailer：

composer require phpmailer/phpmailer

执行完成后，Composer 会自动下载 PHPMailer 及其依赖，并生成 vendor/ 目录和 autoload.php 文件。

2. 手动安装（不推荐，适用于无法使用 Composer 的环境）

如果服务器不支持 Composer，可以手动下载：

• 访问 GitHub：https://github.com/PHPMailer/PHPMailer
• 下载 ZIP 包并解压到项目目录
• 将文件夹重命名为 PHPMailer
• 在代码中手动引入类文件

3. 基本使用方法（通过 SMTP 发送邮件）

以下是一个使用 Gmail SMTP 发送邮件的示例代码：

send_email.php

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

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

$mail = new PHPMailer(true);

try {
    // 启用调试模式（上线时设为 0）
    $mail->isSMTP();
    $mail->Host       = 'smtp.gmail.com';
    $mail->SMTPAuth   = true;
    $mail->Username   = 'your_email@gmail.com';
    $mail->Password   = 'your_app_password'; // 推荐使用应用专用密码
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port       = 587;

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

    // 邮件内容
    $mail->isHTML(true);
    $mail->Subject = '测试邮件标题';
    $mail->Body    = '<h1>这是一封测试邮件</h1><p>支持 HTML 格式内容。</p>';
    $mail->AltBody = '纯文本版本：这是一封测试邮件';

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

4. 注意事项与常见问题

• SMTP 密码安全：Gmail 等邮箱需开启“两步验证”并使用“应用专用密码”，不要使用账户登录密码。
• 服务器环境：确保 PHP 支持 OpenSSL 扩展，否则无法建立加密连接。
• 中文乱码：PHPMailer 默认支持 UTF-8，只要页面编码正确一般不会出现乱码。
• 垃圾邮件过滤：避免频繁发送，设置合理的发件人名称和主题，提高送达率。

5. 其他邮件库简要说明

• Swift Mailer：另一个流行的邮件库，功能强大但已停止维护（最后版本为 v6）。
• Mailgun / SendGrid SDK：如果你使用第三方邮件服务，可直接集成其官方 SDK，通常更稳定。

对于大多数项目，PHPMailer 是最简单实用的选择。