使用PHPMailer可解决PHP发送带附件邮件的编码与兼容性问题。首先通过Composer安装PHPMailer并引入自动加载文件；接着创建PHPMailer实例，配置SMTP参数，包括主机、端口、认证信息及加密方式；然后设置发件人、收件人、主题、HTML正文及附件，支持多附件添加；最后通过try-catch结构调用send()方法发送邮件，并捕获异常以处理SMTP认证失败、网络超时等错误，确保邮件稳定发送。
如果您需要通过PHP程序发送包含附件的电子邮件，直接使用mail()函数会面临编码复杂、兼容性差等问题。PHPMailer是一个功能强大的开源库，能够简化邮件发送流程，并支持附件、HTML内容和SMTP认证等功能。以下是配置与使用PHPMailer发送带附件邮件的具体步骤：
一、安装并引入PHPMailer库
要使用PHPMailer，必须先将其集成到项目中。推荐使用Composer进行安装，以确保依赖管理清晰且版本可控。
1、在项目根目录打开命令行工具，执行以下命令安装PHPMailer：composer require phpmailer/phpmailer。
2、安装完成后，确保项目中存在vendor/autoload.php文件，该文件用于自动加载PHPMailer类。
立即学习“PHP免费学习笔记（深入）”；
3、在发送邮件的PHP脚本顶部引入自动加载文件：require 'vendor/autoload.php';。
二、配置SMTP服务器参数
使用SMTP协议发送邮件比默认的mail()函数更稳定，并支持身份验证和加密传输。需设置正确的主机、端口、用户名和密码。
1、创建PHPMailer对象实例：$mail = new PHPMailer\PHPMailer\PHPMailer(true);。
2、启用SMTP功能：$mail->isSMTP();。
3、设置SMTP主机地址，例如Gmail为smtp.gmail.com：$mail->Host = 'smtp.gmail.com';。
4、设置SMTP端口号，常用端口为587（TLS）或465（SSL）：$mail->Port = 587;。
5、启用SMTP身份验证：$mail->SMTPAuth = true;。
6、设置发件人邮箱和授权密码（部分邮箱需使用应用专用密码）：$mail->Username = 'your_email@gmail.com'; $mail->Password = 'your_password';。
7、启用TLS加密连接：$mail->SMTPSecure = PHPMailer\PHPMailer\PHPMailer::ENCRYPTION_STARTTLS;。
三、设置邮件内容与附件
在完成SMTP配置后，需要指定邮件的发送者、接收者、主题、正文内容以及附加文件。
1、设置发件人邮箱和名称：$mail->setFrom('from@example.com', 'Sender Name');。
2、添加收件人地址：$mail->addAddress('to@example.com', 'Recipient Name');。
3、设置邮件主题：$mail->Subject = '邮件主题';。
4、设置邮件正文内容，支持HTML格式：$mail->Body = ' 包含一个附件。这是一封测试邮件
5、可选：设置纯文本备选内容：$mail->AltBody = '您的邮件客户端不支持HTML，请查看纯文本内容。';。
6、添加附件文件，提供文件路径即可：$mail->addAttachment('/path/to/file.pdf');。
7、如需添加多个附件，重复调用addAttachment方法即可。
四、发送邮件并处理异常
邮件配置完成后，调用send()方法尝试发送，并通过异常捕获机制处理可能发生的错误。
1、将发送代码包裹在try-catch结构中，以便捕获PHPMailer抛出的异常：try { $mail->send(); echo '邮件已成功发送'; } catch (Exception $e) { echo '邮件发送失败：', $mail->ErrorInfo; }。
2、若未启用异常模式（即构造时未传入true），则需手动检查send()返回值是否为true。
3、常见错误包括SMTP认证失败、网络连接超时、附件路径无效等，应根据错误信息逐一排查。
