引言
在本地（例如使用 XAMPP 搭建的 WordPress 环境）进行开发时，测试 WordPress 的邮件发送功能是一个常见需求。然而，尝试通过外部 SMTP 插件或服务发送邮件往往面临诸多挑战，例如邮件被邮件提供商阻止、发送不稳定或配置复杂。为了简化本地邮件测试，一个高效的解决方案是将邮件直接保存到本地文件，而不是尝试发送到真实的邮箱地址。本文将详细介绍如何通过配置 macOS 系统自带的 Postfix 邮件服务器来实现这一目标。
核心思路：利用本地 Sendmail 投递
WordPress 的 wp_mail() 函数在没有特定 SMTP 配置时，会尝试使用系统提供的 sendmail 二进制文件来发送邮件。sendmail 通常是 Postfix 或其他邮件传输代理（MTA）的前端。因此，我们的核心策略是配置一个本地 Postfix 服务器，使其能够接收并本地投递邮件，而不是将其转发到外部网络。
步骤一：移除现有 SMTP 插件
首先，确保您的 WordPress 安装中没有任何已激活的 SMTP 插件（如 WP Mail SMTP、Sendinblue 等）。这些插件会覆盖 WordPress 默认的邮件发送机制，强制使用外部 SMTP 服务，从而阻止 wp_mail() 调用本地的 sendmail。
步骤二：配置本地 Postfix 服务器
Postfix 是一个流行的邮件传输代理（MTA），在 macOS 上通常已经预装。如果未安装，您可以通过 Homebrew 进行安装：brew install postfix。
接下来，您需要编辑 Postfix 的主配置文件 /etc/postfix/main.cf。请注意，编辑系统文件需要管理员权限。
-
备份配置文件： 在修改之前，始终建议备份原始配置文件：
sudo cp /etc/postfix/main.cf /etc/postfix/main.cf.bak
-
编辑 main.cf： 使用文本编辑器打开文件：
sudo nano /etc/postfix/main.cf
-
添加或修改以下配置项：
# 设置本地主机名，用于标识邮件服务器 myhostname = mail.example.com # 定义邮件服务器监听的网络接口，这里设置为本地主机名和 localhost， # 确保只处理本地邮件，不监听外部请求 inet_interfaces = $myhostname, localhost # 定义本地邮件的接收域，确保发往这些域的邮件在本地处理 mydestination = $myhostname, localhost.$mydomain, localhost # 定义网络样式为 'host'，表示只处理本机发出的邮件，不进行网络转发 mynetworks_style = host # 清空 relay_domains，表示不将邮件中继到其他域，所有邮件都在本地处理 relay_domains =
- myhostname: 设定一个虚拟的主机名，例如 mail.example.com。这有助于 Postfix 识别自己。
- inet_interfaces: 指定 Postfix 监听的网络接口。设置为 $myhostname, localhost 意味着它只响应发往 mail.example.com 和 localhost 的邮件请求，不接受来自外部网络的连接。
- mydestination: 定义 Postfix 认为属于自己的域。发往这些域的邮件将被本地投递。
- mynetworks_style = host: 限制 Postfix 只处理来自本地主机的邮件，不充当开放中继。
- relay_domains =: 将此项留空是关键，它指示 Postfix 不要将邮件转发到其他域，所有邮件都应在本地处理。
保存并退出文件。
-
启动或重启 Postfix 服务：
sudo postfix start # 如果是第一次启动 sudo postfix reload # 如果 Postfix 已经在运行，重新加载配置
您可以通过 postfix status 检查服务状态。
步骤三：修改 /etc/hosts 文件
为了让系统能够正确解析 myhostname 中设置的虚拟域名，您需要在 /etc/hosts 文件中添加一个映射。
-
编辑 /etc/hosts：
sudo nano /etc/hosts
-
在 127.0.0.1 localhost 行后添加您的 myhostname：
127.0.0.1 localhost mail.example.com
这将把 mail.example.com 解析到本地回环地址 127.0.0.1。
保存并退出文件。
步骤四：配置邮件收件人
这一步至关重要：您发送邮件的收件人必须是您本地机器上的一个真实非系统用户，并且该用户拥有一个有效的家目录。
例如，如果您的 macOS 用户名是 your_username，那么您可以将邮件发送到 your_username@mail.example.com 或 your_username@localhost。Postfix 会将发往这些地址的邮件投递到该用户的邮箱目录。
重要提示： 请确保该用户在您的系统中是存在的，并且不是系统内部账户（如 nobody、_lp 等）。
步骤五：WordPress 邮件测试
现在，您可以配置 WordPress 来发送邮件。例如，您可以更改 WordPress 管理员邮箱地址为 your_username@mail.example.com。当 WordPress 尝试发送确认邮件时，这封邮件将不会离开您的本地机器，而是被 Postfix 捕获并投递到 your_username 用户的本地邮箱。
您也可以通过自定义 PHP 代码来测试：
');
$sent_message = wp_mail( $to, $subject, $message, $headers);
if ( $sent_message ) {
echo '测试邮件已成功发送到本地。';
} else {
echo '测试邮件发送失败！请检查配置和日志。';
}
?>步骤六：查看本地邮件
成功发送的邮件将存储在收件人用户家目录下的 Maildir 目录中。
例如，如果您的用户名是 your_username，邮件通常会存储在：
/Users/your_username/Maildir/new/
您可以通过终端进入该目录并查看邮件文件：
ls /Users/your_username/Maildir/new/ cat /Users/your_username/Maildir/new/<邮件文件名>
这些文件是纯文本格式，您可以直接阅读其内容。
故障排除
-
检查 Postfix 日志： 如果邮件没有按预期投递，最先应该检查的是 Postfix 的日志文件。在 macOS 上，通常是：
tail -f /var/log/maillog
这个日志文件会提供关于邮件处理过程的详细信息，包括任何错误或配置问题。
- 确保 Postfix 服务正在运行： 使用 sudo postfix status 确认。
- 检查收件人用户是否存在： 确保您使用的收件人地址对应一个真实的本地用户。
- 检查 /etc/hosts 和 main.cf 配置： 仔细核对所有配置项是否与本文描述一致，特别是 myhostname 和 relay_domains。
- 权限问题： 确保 Postfix 对 /var/log/maillog 和用户家目录下的 Maildir 有写入权限。
总结
通过以上步骤，您已经成功配置了一个本地 Postfix 服务器，使得 WordPress 发送的邮件能够直接投递到本地文件系统。这种方法提供了一个稳定、可靠且无需外部网络连接的邮件测试环境，极大地提高了本地开发的效率和便捷性。记住，关键在于移除外部 SMTP 插件、正确配置 Postfix 以进行本地投递，并将邮件发送给一个本地存在的用户。
