PHPMailer发送带附件邮件教程

使用PHPMailer发送带附件的邮件需依次完成以下步骤：1. 安装PHPMailer，推荐通过Composer安装或手动引入；2. 实例化对象并配置SMTP参数，包括服务器地址、身份验证、加密方式等；3. 设置发件人、收件人、主题和正文内容；4. 使用addAttachment()方法添加一个或多个附件，确保路径正确；5. 调用send()方法发送邮件，并处理可能的错误信息；常见问题包括SMTP配置错误、文件路径不正确或附件大小受限，可通过开启调试模式排查问题。

发送带附件的邮件在PHP中其实并不复杂，但很多人一开始都会被各种函数和参数搞得有点晕。如果你只是想用PHP实现发送带附件的邮件，推荐使用一个成熟的库：PHPMailer。

它功能强大、支持SMTP、兼容性强，而且文档也相对完善。下面我们就一步步来介绍怎么用PHPMailer实现带附件的邮件发送。

1. 安装PHPMailer

最推荐的方式是通过 Composer 安装：

composer require phpmailer/phpmailer

如果你不能使用 Composer，也可以手动下载 PHPMailer 的源码放到项目目录里，然后手动引入类文件。

安装完成后，在你的 PHP 文件中引入自动加载文件：

require 'vendor/autoload.php';

2. 基本配置与发送流程

使用 PHPMailer 发送邮件的基本流程包括以下几个步骤：

• 实例化 PHPMailer 对象
• 设置 SMTP 配置（可选）
• 设置发件人、收件人、主题、正文内容
• 添加附件（如果需要）
• 调用 send() 方法发送

示例代码如下：

$mail = new PHPMailer\PHPMailer\PHPMailer();

$mail->isSMTP();                                      // 使用 SMTP 协议发送
$mail->Host = 'smtp.example.com';                     // SMTP 服务器地址
$mail->SMTPAuth = true;                               // 启用身份验证
$mail->Username = 'your@example.com';                 // SMTP 用户名
$mail->Password = 'yourpassword';                     // SMTP 密码
$mail->SMTPSecure = 'tls';                            // 加密协议，如 tls 或 ssl
$mail->Port = 587;                                    // TCP 端口

$mail->setFrom('from@example.com', 'Your Name');      // 设置发件人
$mail->addAddress('to@example.com', 'Recipient Name'); // 收件人
$mail->isHTML(true);                                  // 设置为 HTML 格式
$mail->Subject = 'Here is the subject';               // 邮件主题
$mail->Body    = 'This is the HTML message body in bold!';
$mail->AltBody = 'This is the body in plain text for non-HTML mail clients';

// 添加附件
$mail->addAttachment('/path/to/file.pdf', 'new_name.pdf'); // 可指定显示名称

if(!$mail->send()) {
    echo 'Message could not be sent.';
    echo 'Mailer Error: ' . $mail->ErrorInfo;
} else {
    echo 'Message has been sent';
}

3. 添加多个附件的方法

有时候你想添加多个附件，比如 PDF、图片、Excel 表格等。你可以多次调用 addAttachment() 方法：

$mail->addAttachment('/path/to/file1.pdf');
$mail->addAttachment('/path/to/image.jpg', 'photo.jpg'); // 第二个参数是可选的显示名
$mail->addAttachment('/path/to/report.xlsx');

注意：

• 如果你传入的路径不对，或者权限不够，可能会导致附件无法添加，程序也不会报错，所以要确保路径正确。
• 附件大小也要注意，有些 SMTP 服务商限制了附件最大尺寸，比如 Gmail 每封邮件最多只能发 25MB。

4. 常见问题与调试技巧

• 邮件没收到？
  检查是否开启了 SMTP 认证、用户名密码是否正确、是否启用了加密方式（TLS/SSL）。

• 附件没发出去？
  查看文件路径是否正确，可以通过 file_exists() 先判断是否存在。

• 提示“Could not instantiate mail function”？
  这通常是因为没有设置 SMTP，而服务器不支持 mail() 函数。建议始终使用 SMTP 方式发送。

• 调试模式开启方法：
  在实例化后加上 $mail->SMTPDebug = 2;，可以看到详细的错误信息。

基本上就这些操作了。整个过程看起来步骤不少，但只要配置好一次，后续就可以直接复用模板。PHPMailer 是一个非常实用的工具，尤其是处理附件和 HTML 内容时，比原生的 mail() 函数灵活得多。只要把 SMTP 配置弄清楚，剩下的就是拼接内容和附件的事儿了。