PHPMailer发信教程：轻松实现邮件发送

积累知识，胜过积蓄金银！毕竟在文章开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《PHP邮件发送教程：使用PHPMailer发信详解》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

推荐使用PHPMailer实现PHP邮件发送，因其支持SMTP认证、SSL/TLS加密、HTML内容与附件添加，且可靠性高。通过Composer安装后，配置SMTP服务器信息（如Host、Port、加密方式），设置发件人、收件人、主题及HTML或纯文本内容，并调用send()方法发送。相比PHP内置mail()函数依赖服务器MTA且功能局限，PHPMailer直接与SMTP服务器通信，送达率更高，功能更完善。常见问题包括：使用应用专用密码而非邮箱登录密码进行SMTP认证；确保端口（465对应SMTPS，587对应STARTTLS）与加密方式匹配；检查服务器防火墙是否限制SMTP端口；设置$mail->CharSet = 'UTF-8'避免乱码；大附件发送时注意PHP执行时间限制。发送HTML邮件需调用$isHTML(true)，并提供AltBody作为纯文本备用；内嵌图片可用AddEmbeddedImage配合cid引用；添加附件使用addAttachment指定文件路径和显示名称。

PHP要实现邮件发送，其实有很多种方法，但如果你想做得靠谱、功能全面，而且还希望少踩坑，那我个人会强烈推荐你用PHPMailer这个库。它不是什么新鲜玩意儿，但确实是经过时间检验的解决方案，能帮你轻松搞定SMTP协议那些复杂事儿，不管是带附件、发HTML邮件，还是需要SSL/TLS加密，它都能处理得游刃有余。

解决方案

好吧，既然决定用PHPMailer了，那我们来聊聊具体怎么操作。首先，你得把它请到你的项目里。最现代的方式，当然是Composer了。

// 1. 安装PHPMailer (如果你还没装的话，在项目根目录运行)
// composer require phpmailer/phpmailer

// 2. 引入PHPMailer类
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php'; // 假设你用Composer安装，并自动加载

// 3. 创建PHPMailer实例
$mail = new PHPMailer(true); // 传入true表示启用异常处理，这样可以捕获更多错误

try {
    // 4. 服务器配置 (这里以一个通用SMTP服务为例，你需要替换成你的SMTP服务提供商信息)
    // 调试模式：开发时非常有用，会输出SMTP通信的详细日志
    $mail->SMTPDebug = SMTP::DEBUG_SERVER; // 生产环境通常设置为0或关闭

    $mail->isSMTP(); // 告诉PHPMailer使用SMTP协议
    $mail->Host       = 'smtp.your-email-provider.com'; // 你的SMTP服务器地址，比如 'smtp.gmail.com', 'smtp.qq.com'
    $mail->SMTPAuth   = true; // 启用SMTP认证
    $mail->Username   = 'your_email@example.com'; // 你的SMTP用户名 (通常是你的邮箱地址)
    $mail->Password   = 'your_email_password_or_app_password'; // 你的SMTP密码或应用专用密码

    // 加密方式：推荐使用PHPMailer::ENCRYPTION_SMTPS (端口465) 或 PHPMailer::ENCRYPTION_STARTTLS (端口587)
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS; 
    $mail->Port       = 465; // SMTP端口，如果是SMTPS通常是465，STARTTLS通常是587

    // 5. 收件人、发件人设置
    $mail->setFrom('from@example.com', '发件人名称'); // 发件人邮箱和名称，这个邮箱必须是你SMTP认证的邮箱
    $mail->addAddress('recipient@example.com', '收件人名称'); // 收件人邮箱和名称
    // $mail->addReplyTo('info@example.com', '回复'); // 设置回复地址
    // $mail->addCC('cc@example.com', '抄送人'); // 抄送
    // $mail->addBCC('bcc@example.com', '密送人'); // 密送

    // 6. 内容设置
    $mail->isHTML(true); // 设置邮件格式为HTML
    $mail->Subject = '这是一封来自PHPMailer的测试邮件'; // 邮件主题
    $mail->Body    = '<b>你好，这是一封HTML格式的邮件内容！</b><p>你可以加入图片、链接等。</p>'; // HTML邮件内容
    $mail->AltBody = '你好，这是一封纯文本格式的邮件内容！'; // 纯文本邮件内容 (当HTML邮件无法显示时，非常重要)

    // 7. 发送邮件
    $mail->send();
    echo '邮件发送成功！';
} catch (Exception $e) {
    // 捕获异常，输出详细错误信息
    echo "邮件发送失败。错误信息: {$mail->ErrorInfo}";
    // 调试时，你可能还会想看更底层的错误
    // echo "PHPMailer Error: {$e->getMessage()}";
}

为什么PHPMailer比PHP内置的mail()函数更值得信赖？

说到邮件发送，PHP本身是提供了一个mail()函数的，很多人一开始可能都会想到它。但说实话，这个函数在实际项目里，我个人是很少直接用的。它用起来确实简单，一行代码可能就发出去了，但背后的逻辑和可靠性，真的不如PHPMailer来得稳健。

mail()函数实际上是依赖服务器上的sendmail程序（或者其他MTA，邮件传输代理）来发送邮件的。这意味着，它的成功与否，很大程度上取决于你服务器的环境配置。如果sendmail没配置好，或者被禁用，那你的邮件就发不出去，而且你可能连个像样的错误提示都收不到，排查起来简直是噩梦。

PHPMailer就不一样了，它直接通过SMTP协议与邮件服务器通信。这就像你直接跟邮局打交道，而不是把信扔给一个不确定什么时候会来收信的快递员。它能处理SMTP认证、加密连接（SSL/TLS），这些都是现代邮件服务必备的。所以，邮件被标记为垃圾邮件的概率会大大降低，送达率也更高。

再有，mail()函数在处理附件、HTML内容、多语言编码这些高级功能时，会显得非常笨拙和复杂，需要你手动拼接各种MIME头。而PHPMailer把这些都封装好了，你只需要调用几个方法，就能轻松实现。所以，从可靠性、功能丰富度和开发效率来看，PHPMailer绝对是更优的选择，虽然初期配置可能多几行代码，但长远来看，省心太多了。

PHPMailer配置时，这些“坑”你可能遇到过

在使用PHPMailer的过程中，我遇到过不少开发者，包括我自己，都曾被一些配置问题搞得焦头烂额。这些问题往往不是代码逻辑上的，而是环境或配置细节上的。

一个最常见的，就是SMTP认证失败。这通常是你的Username和Password不对。很多人会直接填邮箱登录密码，但有些邮件服务商（比如Gmail、QQ邮箱等）要求你使用应用专用密码或授权码，而不是你的主密码。所以，如果你遇到认证问题，先去你的邮箱服务商设置里看看有没有生成应用密码的选项。

其次，端口和加密方式不匹配也是个大头。PHPMailer支持PHPMailer::ENCRYPTION_SMTPS（通常对应465端口）和PHPMailer::ENCRYPTION_STARTTLS（通常对应587端口）。如果你的SMTP服务器要求TLS但你用了SSL，或者端口对不上，那肯定发不出去。我通常建议先尝试465端口配合PHPMailer::ENCRYPTION_SMTPS，如果不行再试试587端口配合PHPMailer::ENCRYPTION_STARTTLS。

还有，服务器防火墙的问题。你的服务器可能为了安全，限制了对外连接特定端口。比如，你尝试连接Gmail的SMTP服务器（465或587），但服务器的防火墙把这些端口给堵了。这种情况下，你需要联系你的服务器管理员开放这些端口。

另外，别忘了字符编码。如果你的邮件内容出现乱码，很可能是编码问题。PHPMailer默认使用UTF-8，但如果你的数据库或PHP文件本身不是UTF-8，或者你在设置邮件内容时没有明确指定，就可能出问题。确保你的所有内容都是UTF-8编码，或者通过$mail->CharSet = 'UTF-8';明确设置。

最后，PHP执行时间限制。虽然不常见，但如果你的邮件服务器响应慢，或者你要发送大量附件，PHP的默认执行时间可能会不够。这可以通过set_time_limit(0);（不推荐在生产环境无限制）或者适当增加max_execution_time来解决，但更推荐异步发送邮件的方式来避免。

PHPMailer中，让邮件“图文并茂”与“带上文件”的秘诀

现代邮件，谁还喜欢看纯文本啊？所以，怎么在PHPMailer里发送漂亮的HTML邮件和带附件，这是非常实用的功能。其实，PHPMailer在这方面做得非常人性化。

发送HTML邮件： 这很简单，你只需要告诉PHPMailer，你要发送的是HTML内容，然后把你的HTML代码赋值给Body属性就行了。

$mail->isHTML(true); // 重点在这里，告诉PHPMailer这是HTML邮件
$mail->Subject = '带图片和链接的邮件';
$mail->Body    = '<h1>欢迎！</h1><p>这是一封<b>HTML</b>格式的邮件。</p><p>点击这里访问：<a href="https://example.com">我的网站</a></p><img src="cid:my-logo" alt="Logo">';
$mail->AltBody = '欢迎！这是一封纯文本格式的邮件。点击这里访问：https://example.com'; // 纯文本备用内容，非常重要！

// 如果HTML内容中有图片，并且你希望图片是内嵌的，而不是外部链接，可以这样做：
// 注意：图片路径是服务器上的实际路径
// $mail->AddEmbeddedImage('/path/to/your/image.png', 'my-logo', 'logo.png'); // 'my-logo' 是cid，'logo.png'是文件名
// 然后在HTML内容中用 <img src="cid:my-logo"> 引用

AltBody这个属性，我强烈建议你每次都设置。它会在收件人的邮件客户端不支持HTML邮件时显示，或者在预览时显示，这能极大提升用户体验，也避免邮件看起来像垃圾邮件。

添加附件： 添加附件更是直截了当，用addAttachment()方法就行。你可以添加任意类型的文件。

// 添加一个附件
$mail->addAttachment('/path/to/your/file.pdf', '我的文档.pdf'); // 文件路径和在邮件中显示的文件名
// 添加另一个附件，不指定显示文件名，会使用原始文件名
$mail->addAttachment

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。