使用phpmailer发送带附件的邮件需依次完成以下步骤：1. 安装phpmailer，推荐通过composer安装或手动引入；2. 实例化对象并配置smtp参数，包括服务器地址、身份验证、加密方式等；3. 设置发件人、收件人、主题和正文内容；4. 使用addattachment()方法添加一个或多个附件，确保路径正确；5. 调用send()方法发送邮件，并处理可能的错误信息；常见问题包括smtp配置错误、文件路径不正确或附件大小受限，可通过开启调试模式排查问题。
发送带附件的邮件在PHP中其实并不复杂，但很多人一开始都会被各种函数和参数搞得有点晕。如果你只是想用PHP实现发送带附件的邮件，推荐使用一个成熟的库：PHPMailer。
它功能强大、支持SMTP、兼容性强，而且文档也相对完善。下面我们就一步步来介绍怎么用PHPMailer实现带附件的邮件发送。
1. 安装PHPMailer
最推荐的方式是通过 Composer 安装：
立即学习“PHP免费学习笔记（深入）”；
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 配置弄清楚，剩下的就是拼接内容和附件的事儿了。
