XAMPP配置PHP使用Sendmail发送邮件附件教程

如果你正在XAMPP环境下尝试用PHP发送带附件的邮件，并且已经对着空荡荡的C:\xampp\sendmail\目录或者一堆复杂的MIME拼接代码折腾了半天，那么可以停下来了。问题的根源可能比你想象的要简单。

你的 XAMPP 根本没有 sendmail.exe，别白忙了

一个关键的事实是：从XAMPP 7.4版本开始，后续的所有版本都已经移除了内置的sendmail组件。这意味着，无论你是新下载的安装包，还是反复检查配置，那个传说中的sendmail.exe文件在标准安装包里就是不复存在的。所以，当你发现sendmail目录是空的，或者手动塞进去的第三方sendmail.exe怎么也连不上Gmail时，这并非配置失误，而是从一开始就走错了方向。继续执着于修改php.ini里的sendmail_path，很可能只是在浪费时间。

即使补上 sendmail.exe，mail() 也发不出带附件的邮件

退一步讲，即便你设法弄到了一个可用的sendmail.exe，PHP内置的mail()函数本身也根本不支持附件功能。它设计上只处理最基本的收件人、主题、正文和头信息参数。所有关于附件的逻辑，都需要开发者手动构建复杂的MIME多部分邮件结构——包括设置边界符（boundary）、对附件进行Base64编码、正确添加Content-Disposition头等。这个过程对格式要求极为苛刻，一个换行符（必须是\r\n而不是\n）或空格错误，都足以导致邮件被服务器如Gmail直接拒绝（常见的550错误）。网上流传的那些手动拼接附件的代码示例，在真实的邮件服务商严格校验下，成功率极低。

• 附件必须经过Base64编码，且邮件体中的换行符必须严格使用\r\n。
• 邮件头中的Content-Type必须正确声明为multipart/mixed并指定边界符，每个部分（part）的头部和正文之间必须有且仅有一个空行。
• 最棘手的是，mail()函数在发送失败时通常只是静默地返回false，不会提供具体的错误信息，排查起来如同大海捞针。

正确做法：用 PHPMailer 替代 mail()，附件一行代码搞定

更高效的解决方案是放弃原生的mail()函数，转而使用成熟的第三方库，例如PHPMailer。它的优势在于完全绕过了系统自带的邮件传输袋里（MTA），直接通过SMTP协议与邮件服务器（如Gmail的SMTP服务器）通信。所有繁琐的MIME格式化、编码转换、TLS/SSL加密握手以及失败重试机制，都被封装在库内部自动完成。

安装PHPMailer后，添加附件变得异常简单，只需要一行代码：

$mail->addAttachment('path/to/file.pdf', '说明书.pdf');

当然，要成功连接Gmail这样的服务，还需要注意几个关键配置：

• $mail->Host = 'smtp.gmail.com'：建议直接使用这个地址，避免使用其他可能不稳定的DNS别名。
• $mail->Port = 587：这是使用STARTTLS加密的标准端口。也可以使用端口465并配合SMTPS加密模式，但587端口更为通用。
• $mail->Username和$mail->setFrom()中设置的邮箱地址必须完全一致，否则Gmail会返回553错误。
• $mail->Password：这里不能填写你的Gmail登录密码。如果账户开启了两步验证，你必须使用在Google账户设置中生成的16位“应用专用密码”。

最容易被忽略的坑：中文附件名和路径里的空格

即使使用了PHPMailer，在Windows环境下仍然可能遇到一个隐蔽的坑：文件路径。如果附件所在的路径包含中文字符或者空格（例如C:\my project\简历.pdf），addAttachment()方法可能会因为操作系统层面的路径解析问题而静默失败，即不报错但附件并未成功添加。

解决这个问题通常有两个思路：

• 最直接的方法是，先将需要发送的附件文件复制到一个纯英文、无空格的临时路径下（例如C:\temp\resume.pdf），然后再将这个新路径传给addAttachment()。
• 另一种更灵活的方式是，使用file_get_contents()函数读取文件的二进制内容，然后配合PHPMailer的addStringAttachment()方法，将文件内容和指定的文件名（支持UTF-8中文名）一同传入。这样可以完全规避文件系统路径的问题。

需要明确的是，试图通过修改php.ini中的default_charset等配置来解决附件路径问题，是行不通的。因为文件路径的读取是PHP与操作系统交互的行为，PHPMailer库本身并不负责对路径字符串进行转义或转换，这也不应该是它的职责。