最推荐使用PHPMailer库发送邮件，因其支持SMTP认证、SSL/TLS加密、HTML内容和附件处理，远比PHP内置mail()函数稳定。通过Composer安装后，配置SMTP服务器信息（如Host、Port、Username、Password），设置发件人、收件人、主题、HTML内容及附件，调用send()方法发送，并通过异常捕获获取详细错误信息。常见问题包括SMTP配置错误、防火墙限制、认证失败等，可通过开启SMTPDebug调试模式排查。

PHP代码发送邮件，最推荐且最实用的方式是使用像PHPMailer这样的第三方库，它能很好地处理SMTP认证、HTML内容和附件等复杂场景，远比PHP内置的mail()函数可靠和功能强大。

解决方案

要用PHP发送邮件，最稳妥的选择是PHPMailer。它提供了一套完整的解决方案，包括SMTP认证、SSL/TLS加密、HTML邮件、多附件支持以及良好的错误处理机制。以下是一个基础的PHPMailer使用示例，用于通过SMTP发送一封带附件的HTML邮件。

首先，确保你的项目通过Composer安装了PHPMailer： composer require phpmailer/phpmailer

然后，你的PHP代码可以这样组织：

服务器配置
    $mail->SMTPDebug = 0; // 0 = off (for production), 2 = client and server messages
    $mail->isSMTP(); // 使用SMTP
    $mail->Host = 'smtp.your_email_provider.com'; // 你的SMTP服务器地址，例如 'smtp.gmail.com'
    $mail->SMTPAuth = true; // 启用SMTP认证
    $mail->Username = 'your_email@example.com'; // SMTP用户名，通常是你的邮箱地址
    $mail->Password = 'your_email_password'; // SMTP密码
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS; // 启用TLS加密，PHPMailer::ENCRYPTION_STARTTLS 或 PHPMailer::ENCRYPTION_SMTPS
    $mail->Port = 465; // TLS通常用587，SMTPS通常用465

    // 发件人与收件人
    $mail->setFrom('from@example.com', '发件人名称'); // 发件人邮箱和名称
    $mail->addAddress('to@example.com', '收件人名称'); // 收件人邮箱和名称
    // $mail->addReplyTo('info@example.com', '信息'); // 回复邮箱
    // $mail->addCC('cc@example.com'); // 抄送
    // $mail->addBCC('bcc@example.com'); // 密送

    // 附件
    $mail->addAttachment('/tmp/image.jpg', 'new_name.jpg'); // 添加一个附件 (路径, 可选的新文件名)
    $mail->addAttachment('/tmp/document.pdf'); // 添加另一个附件

    // 内容
    $mail->isHTML(true); // 设置邮件格式为HTML
    $mail->Subject = '这是一封测试邮件，带附件和HTML内容';
    $mail->Body    = '
你好！
这是一封由PHPMailer发送的HTML邮件。
';
    $mail->AltBody = '如果收件人不支持HTML，则显示此纯文本内容。'; // 非HTML邮件客户端的备用内容

    $mail->send();
    echo '邮件发送成功！';
} catch (Exception $e) {
    echo "邮件发送失败。错误信息: {$mail->ErrorInfo}";
}
?>

使用PHPMailer库发送邮件的优势与基本配置

说到PHP发送邮件，我个人总是倾向于推荐PHPMailer。坦白说，PHP自带的mail()函数虽然看起来简单，但实际用起来限制太多，尤其是在处理SMTP认证、邮件头编码、附件和HTML内容时，常常让人焦头烂额。PHPMailer则完全是为解决这些痛点而生。

它的核心优势在于：

1. 完整的SMTP支持：你可以通过它轻松连接到几乎任何SMTP服务器，包括Gmail、Outlook等，并支持SMTP认证，这是mail()函数无法直接提供的。
2. 加密连接：支持SSL/TLS加密，这在当今安全至上的网络环境中至关重要，能有效防止邮件内容被窃听。
3. HTML邮件与附件：发送富文本HTML邮件和添加多个附件变得异常简单，不需要手动构建复杂的MIME类型。
4. 错误处理：提供了清晰的错误信息，便于调试和排查问题，而不是让你对着一个布尔返回值摸不着头脑。
5. 跨平台兼容性：在不同的服务器环境和操作系统上都能保持一致的良好表现。

要开始使用PHPMailer，最现代的方式是通过Composer进行安装： composer require phpmailer/phpmailer 这会自动处理依赖关系，并生成vendor/autoload.php文件，你只需要在脚本开头引入它即可。

基本配置涉及SMTP服务器的设置。这通常包括：

• Host: 你的邮件服务提供商的SMTP服务器地址（例如，Gmail是smtp.gmail.com）。
• Port: SMTP服务器的端口。对于TLS加密通常是587，对于SSL加密通常是465。
• Username 和 Password: 你的邮箱账号和密码。注意：出于安全考虑，生产环境中不建议直接将密码硬编码在代码中，应使用环境变量或配置文件管理。
• SMTPSecure: 指定加密方式，PHPMailer::ENCRYPTION_STARTTLS（推荐）或 PHPMailer::ENCRYPTION_SMTPS。

正确的配置是邮件成功发送的第一步，也是最容易出错的地方。我经常看到开发者因为端口、加密方式或认证信息不匹配而卡住。所以，务必仔细核对你的邮件服务商提供的SMTP配置信息。

如何在PHP邮件中添加附件与HTML内容

邮件内容不再是简单的纯文本，用户期待更丰富的体验。PHPMailer在这方面做得非常出色，添加HTML内容和附件都非常直观。

要发送HTML格式的邮件，你只需要设置$mail->isHTML(true);，然后将你的HTML代码赋给$mail->Body属性。例如： $mail->Body = '

欢迎！

这是一封漂亮的HTML邮件。

添加附件则通过$mail->addAttachment()方法实现。这个方法可以接受两个参数：第一个是附件文件的完整路径，第二个是可选的，用于指定附件在邮件中显示的文件名。如果不指定第二个参数，则使用原始文件名。 $mail->addAttachment('/path/to/your/file.pdf', '我的报告.pdf');$mail->addAttachment('/path/to/another/image.jpg'); 你可以调用多次addAttachment()来添加多个文件。需要注意的是，附件文件必须是服务器上可访问的真实文件路径。如果你想发送一个内存中的文件（例如，动态生成的PDF），你需要将其先保存到临时文件，或者使用addStringAttachment()方法，但这会稍微复杂一些。

关于附件，有个小细节值得注意：邮件服务商通常会对附件大小有严格限制，比如25MB。如果你需要发送更大的文件，邮件附件并不是最佳选择，考虑使用云存储服务，然后将下载链接放在邮件正文中。此外，某些特定类型的文件（如可执行文件）可能会被邮件服务商拦截，这也是需要提前考虑的。

PHP邮件发送常见的陷阱与排查技巧

即使有了PHPMailer这样的利器，邮件发送过程中也难免会遇到各种问题。我处理过不少邮件发送失败的案例，总结下来，常见的陷阱主要集中在几个方面：

1. SMTP连接问题：

   • 防火墙：服务器的防火墙可能阻止了PHP脚本连接外部SMTP服务器的特定端口（如465或587）。检查服务器防火墙规则，确保这些端口是开放的。
   • SMTP主机或端口错误：最常见的错误。务必核对你的邮件服务商提供的SMTP主机名和端口。例如，Gmail的SMTP是smtp.gmail.com，端口通常是465（SSL）或587（TLS）。
   • 认证失败：Username或Password不正确。有些服务商可能需要生成“应用专用密码”而不是你的主账户密码。检查你的邮箱设置。
   • 加密方式不匹配：SMTPSecure设置与服务器要求的加密方式不符。尝试切换PHPMailer::ENCRYPTION_SMTPS和PHPMailer::ENCRYPTION_STARTTLS，并调整端口。

2. 发件人/收件人问题：

   • 无效邮箱地址：收件人邮箱地址格式不正确或不存在。PHPMailer会抛出异常。
   • 发件人邮箱权限：有些SMTP服务器要求发件人邮箱（setFrom()）必须是你用于SMTP认证的邮箱。
   • SPF/DKIM记录：如果你的域名没有正确配置SPF和DKIM记录，邮件可能会被标记为垃圾邮件或直接拒绝。这不是PHPMailer能直接解决的问题，但它会影响邮件的投递率。

3. 编码问题：

   • 中文字符乱码：邮件主题或内容中的中文字符显示乱码。确保你的PHP文件保存为UTF-8编码，并且PHPMailer的CharSet属性设置为UTF-8（默认就是）。

4. PHPMailer自身的错误信息：

   • 利用$mail->SMTPDebug = 2;（或更高）来开启调试模式。这会在执行过程中输出SMTP服务器的详细交互日志，这是排查连接和认证问题的金钥匙。
   • 捕获Exception $e并输出$mail->ErrorInfo。PHPMailer的错误信息通常非常具体，能直接指出问题所在。

我的经验是，当你遇到邮件发送问题时，第一步永远是开启SMTPDebug。它会直接告诉你PHPMailer和SMTP服务器之间发生了什么，比如“Authentication failed”或“Connection refused”，这些信息比任何猜测都来得有效。另外，如果你的服务器环境是共享主机，有时邮件发送功能会受到限制，这种情况下可能需要联系主机提供商了解他们的邮件发送策略。