PHP如何发送电子邮件？PHPMailer使用教程

看不見的法師

发布时间：2025-08-05 16:46:01

745人浏览过

来源于php中文网

原创

phpmailer相比mail()函数的优势在于支持smtp认证和加密、提供详细错误报告、支持html邮件与附件等富内容、兼容性更好且有活跃社区维护；2. 处理phpmailer常见错误需检查smtp配置（host、port、username、password、加密方式）、启用smtpdebug调试日志、排查防火墙限制，并注意邮件内容规范及spf/dkim/dmarc域名配置以提升送达率；3. 生产环境中需避免敏感信息硬编码，使用环境变量管理凭证，严格验证用户输入防止邮件头注入，强制启用tls/ssl加密，及时更新phpmailer版本，通过消息队列异步发送大量邮件以提升性能，合理复用连接并优化邮件内容大小。

PHP如何发送电子邮件？PHPMailer使用教程

PHP要发送电子邮件，通常不会直接依赖内置的

mail()

函数，因为其功能有限且错误处理不佳。更实际、更可靠的做法是使用像 PHPMailer 这样的第三方库。它能让你通过SMTP协议与邮件服务器进行交互，从而发送更专业、更复杂的邮件，包括HTML内容、附件以及处理各种认证方式。

解决方案

使用 PHPMailer 发送电子邮件的核心步骤，在于配置好你的SMTP服务器信息，然后构建邮件内容。以下是一个基础的示例，展示了如何配置并发送一封简单的HTML邮件：

你需要先通过 Composer 安装 PHPMailer：

composer require phpmailer/phpmailer

。

立即学习“PHP免费学习笔记（深入）”；

<?php
// 引入 PHPMailer 类的文件
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

// 如果你使用 Composer，通常只需要引入 autoload.php
require 'vendor/autoload.php';

$mail = new PHPMailer(true); // 启用异常处理，出错时会抛出 Exception

try {
    // 服务器配置
    $mail->SMTPDebug = 0; // 启用详细的调试输出，0 表示关闭，2 表示客户端和服务器交互信息
    $mail->isSMTP(); // 使用 SMTP
    $mail->Host = 'smtp.example.com'; // 你的 SMTP 服务器地址，比如 smtp.qq.com, smtp.163.com, 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 或 SSL 加密，推荐 PHPMailer::ENCRYPTION_SMTPS
    $mail->Port = 465; // SMTP 端口，对于 SMTPS 通常是 465，对于 STARTTLS 通常是 587

    // 收件人
    $mail->setFrom('your_email@example.com', '你的名字或公司名'); // 发件人地址和名称
    $mail->addAddress('recipient@example.com', '收件人名称'); // 添加收件人
    // $mail->addReplyTo('info@example.com', '信息'); // 回复地址
    // $mail->addCC('cc@example.com'); // 抄送
    // $mail->addBCC('bcc@example.com'); // 密送

    // 附件
    // $mail->addAttachment('/var/tmp/file.tar.gz'); // 添加附件
    // $mail->addAttachment('/tmp/image.jpg', 'new.jpg'); // 附件名称可以自定义

    // 内容
    $mail->isHTML(true); // 邮件内容是否为 HTML 格式
    $mail->Subject = '这是一封来自PHPMailer的测试邮件';
    $mail->Body    = '<h1>你好，这是一封HTML测试邮件！</h1><p>这封邮件是通过PHPMailer发送的，内容可以是<b>富文本</b>格式。</p>';
    $mail->AltBody = '你好，这是一封纯文本测试邮件！你的邮件客户端不支持HTML格式，所以你看到了这部分内容。'; // 纯文本替代内容，以防HTML显示不正常

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

这个例子里，

$mail->Host

、

$mail->Username

和

$mail->Password

需要替换成你自己的邮件服务商提供的SMTP信息。很多邮箱服务商为了安全，会要求你使用“授权码”而不是邮箱登录密码作为

$mail->Password

。

PHPMailer相比原生PHP

mail()

函数有哪些优势？

谈到PHP发送邮件，很多人可能首先想到的是内置的

mail()

函数。但说实话，在实际项目里，我几乎不会选择它。PHPMailer 之所以成为主流，优势非常明显，甚至可以说是碾压式的。

mail()

函数的局限性在于，它严重依赖于服务器上的

sendmail

或兼容程序配置。这意味着你无法直接控制邮件发送过程，比如进行SMTP认证。如果你的服务器没有正确配置邮件发送代理，或者你需要在共享主机环境下发送邮件，

mail()

往往会让你一头雾水，邮件发不出去，还没有任何有用的错误提示。

PHPMailer 则完全不同。它直接通过SMTP协议与邮件服务器通信，这意味着：

SMTP认证和加密支持： PHPMailer 可以直接配置用户名和密码进行SMTP认证，并支持SSL/TLS加密连接，这在当前几乎是邮件发送的标配，确保邮件的安全性和送达率。
```
mail()
```
根本不具备这些能力。
详细的错误报告： 当邮件发送失败时，PHPMailer 会通过
```
ErrorInfo
```
属性提供非常详细的错误信息，这对于排查问题简直是福音。而
```
mail()
```
呢？通常只返回一个布尔值，告诉你“成功”或“失败”，至于为什么失败，你得自己去翻服务器日志，那感觉就像大海捞针。
丰富的邮件内容支持： 发送HTML格式的邮件、添加附件、设置抄送/密送、自定义邮件头等，PHPMailer 都提供了直观的API。用
```
mail()
```
来实现这些功能，你需要手动构建复杂的MIME类型头部，那过程简直是噩梦，而且容易出错。
更强的兼容性： PHPMailer 内部处理了各种邮件客户端和服务器的兼容性问题，比如字符编码、行结束符等，这让你的邮件在各种环境下都能正确显示。
社区支持和维护： 作为开源项目，PHPMailer 有活跃的社区和持续的维护，这意味着你可以获得及时的更新和帮助。

在我看来，选择 PHPMailer 不仅仅是选择了一个库，更是选择了一种更可靠、更高效、更省心的邮件发送方式。它把那些繁琐且容易出错的底层细节都封装好了，让你能更专注于业务逻辑。

如何处理PHPMailer发送邮件时可能遇到的常见错误？

在使用PHPMailer过程中，邮件发不出去是常有的事，毕竟这涉及到网络、服务器、邮件服务商等多方面因素。遇到问题时，首先别慌，PHPMailer提供了相当不错的调试机制。

CreateWise AI

为播客创作者设计的AI创作工具，AI自动去口癖、提交亮点和生成Show notes、标题等

下载

最常见的问题，往往出在SMTP配置上。

SMTP连接失败或认证失败： 这通常是
```
Host
```
、
```
Port
```
、
```
Username
```
、
```
Password
```
或
```
SMTPSecure
```
配置不正确。
- 检查
  Host
  和
  Port
  ：确保你的SMTP主机地址和端口是正确的。比如，Gmail的SMTP主机是
```
smtp.gmail.com
```
  ，端口通常是 465（SSL）或 587（TLS）。不同的邮件服务商会有不同的配置。
- 检查
  Username
  和
  Password
  ：确认你的邮箱用户名和密码（或授权码）是正确的。很多服务商为了安全，要求你使用独立的“授权码”作为PHPMailer的密码，而不是你邮箱的登录密码。
- 检查
  SMTPSecure
  ：如果你使用了SSL/TLS加密，确保
```
SMTPSecure
```
  设置为
```
PHPMailer::ENCRYPTION_SMTPS
```
  (推荐SSL，端口465) 或
```
PHPMailer::ENCRYPTION_STARTTLS
```
  (推荐TLS，端口587)。同时，确保你的PHP环境支持SSL/TLS，并且服务器防火墙没有阻止这些端口。
- 防火墙问题： 有时候，服务器的防火墙会阻止PHP脚本连接到外部的SMTP端口。你需要检查服务器的入站/出站规则。
邮件发送被拒或进入垃圾箱： 即使邮件成功发送，也可能被收件方拒收或标记为垃圾邮件。
- 发件人信誉： 如果你的发件邮箱信誉不好，或者IP地址被列入黑名单，邮件很容易被拒。
- 邮件内容： 避免在邮件主题或内容中使用过多垃圾邮件常用词汇。确保邮件内容专业、规范。
- SPF/DKIM/DMARC记录： 这是一个比较高级但很重要的概念。为你的域名配置正确的SPF、DKIM和DMARC记录，可以有效提高邮件的送达率，告诉收件方你的邮件是合法的。如果你用的是自己的域名邮箱，这几乎是必须做的。
PHPMailer 的调试利器：
```
SMTPDebug
```
和
ErrorInfo
：
- $mail->SMTPDebug = 2;
  ：在开发调试阶段，将
```
SMTPDebug
```
  设置为
```
2
```
  或更高（最高4），它会输出PHPMailer与SMTP服务器之间的详细通信日志。通过这些日志，你可以清晰地看到在哪一步出了问题，是连接不上，还是认证失败，或是发送内容有问题。
- $mail->ErrorInfo
  ：当
```
send()
```
  方法返回
```
false
```
  或捕获到
```
Exception
```
  时，
```
$mail->ErrorInfo
```
  会包含具体的错误信息。务必打印这个信息，它是你排查问题的关键线索。

处理这些问题时，我的经验是，先从最基本的配置开始检查，然后逐步深入到网络环境和邮件服务器的日志。很多时候，一个小小的端口号错误或者一个授权码的遗漏，就能让你抓狂好久。

PHPMailer在生产环境中需要注意哪些性能和安全性问题？

在开发阶段，我们可能只关注邮件能不能发出去。但一旦投入生产环境，性能和安全性就变得至关重要了。PHPMailer虽然强大，但使用不当也可能带来隐患。

安全性方面：

敏感信息硬编码： 绝对不要将SMTP的用户名和密码直接硬编码在代码中。这是非常危险的做法。正确的姿势是将其存储在环境变量、配置文件（且不提交到版本控制系统）、或秘密管理服务中。PHP的
```
.env
```
文件或服务器环境变量都是不错的选择。
用户输入验证与过滤： 如果你的邮件内容、主题、收件人地址等是来自用户输入，务必进行严格的验证和过滤。这能有效防止邮件头注入（Email Header Injection）等攻击。比如，不要直接将用户输入的字符串作为
```
addAddress()
```
或
```
Subject
```
的参数，要确保它们是合法的邮箱地址或纯文本，去除潜在的恶意字符。PHPMailer内部对一些常见注入有防护，但外部输入仍然需要你来把控。
使用TLS/SSL加密： 始终通过
```
SMTPSecure
```
启用加密连接（
```
PHPMailer::ENCRYPTION_SMTPS
```
或
```
PHPMailer::ENCRYPTION_STARTTLS
```
）。这能防止邮件内容和认证信息在传输过程中被窃听。
及时更新PHPMailer版本： 保持PHPMailer库的最新版本非常重要。开发者会不断修复潜在的安全漏洞和bug，更新能确保你的应用获得最新的安全防护。

性能方面：

避免同步大量发送： 如果你的应用需要发送大量邮件（比如群发通知），直接在用户请求中同步发送会严重阻塞请求，导致页面响应缓慢甚至超时。
- 异步处理： 最好的做法是将邮件发送任务放入队列（Message Queue）中，然后由独立的后台进程（Worker）异步地从队列中取出任务并发送邮件。常见的队列系统有 Redis (结合
```
php-resque
```
  或
```
laravel-queue
```
  )、RabbitMQ、Kafka等。这样用户请求可以立即响应，邮件发送则在后台慢慢进行。
连接复用： 如果在同一个请求生命周期内需要发送多封邮件（虽然这种情况不常见，但也有可能），可以考虑复用PHPMailer的实例。每次都重新实例化
```
PHPMailer
```
对象并建立SMTP连接会增加不必要的开销。不过，对于大多数单个请求发送一封或几封邮件的场景，这通常不是瓶颈。
优化邮件内容： 避免发送过大的HTML邮件或过多附件，这会增加邮件服务器的负担和传输时间。压缩附件，优化HTML结构，保持邮件内容的简洁高效。