将本地 php 邮件测试环境从 mailhog 迁移到 mailpit,核心做法是替换 docker 容器镜像并调整端口映射。mailhog 已停止维护且存在已知安全漏洞,而 mailpit 作为其继任者,提供了更现代的界面和持续的安全更新。只需在 docker-compose.yml 中将服务镜像改为 axllent/mailpit,并将内部端口 1025(smtp)和 8025(web ui)映射到宿主机即可。php 代码无需修改,因为两者均遵循标准的 smtp 协议规范。

Docker Compose 配置如何调整以运行 Mailpit
在 Docker Compose 文件中,需要定义一个新的服务或使用现有服务但更改其镜像。Mailpit 默认监听 1025 端口用于接收邮件,8025 端口用于 Web 界面。配置时需确保这两个端口正确映射到宿主机,以便 PHP 应用能连接 SMTP 服务,开发者能访问 Web UI。

version: '3.8'
services:
mailpit:
image: axllent/mailpit
container_name: mailpit
restart: unless-stopped
ports:
- "1025:1025" # SMTP 端口,供 PHP 使用
- "8025:8025" # Web UI 端口,供开发者查看
volumes:
- ./data:/data # 持久化存储邮件数据
environment:
- MP_SMTP_AUTH_ACCEPT_ANY=true
- MP_SMTP_AUTH_ALLOW_INSECURE=true
上述配置中,MP_SMTP_AUTH_ACCEPT_ANY 和 MP_SMTP_AUTH_ALLOW_INSECURE 环境变量允许任何客户端连接且无需认证,这简化了本地开发环境的设置,使其与之前 MailHog 的行为一致。数据卷挂载确保了重启容器后邮件记录不会丢失。
立即学习“PHP免费学习笔记(深入)”;
通过 Docker 或 docker compose 部署独立的 LYGO 协议栈社区节点。构建 lygo-node镜像,启动健康检查 API 于端口 8787,可选 Phase 4...
PHPMailer 或 SwiftMailer 配置需做哪些变更
对于大多数 PHP 邮件库如 PHPMailer 或 SwiftMailer,配置变更仅限于主机名和端口号。由于 Mailpit 的 SMTP 服务运行在 localhost 的 1025 端口,开发者只需更新邮件发送器的配置参数。如果使用 sendmail 路径,则无需更改,因为 Mailpit 通常通过 SMTP 协议提供服务,而非模拟 sendmail 二进制文件。

$mail = new PHPMailer(true);
try {
// 服务器设置
$mail->isSMTP();
$mail->Host = 'localhost'; // 指向本地 Mailpit 容器
$mail->SMTPAuth = false; // 本地开发通常关闭认证
$mail->Port = 1025; // Mailpit 默认 SMTP 端口
// 收件人
$mail->setFrom('from@example.com', 'Mailer');
$mail->addAddress('recipient@example.com', 'Recipient');
// 内容
$mail->Subject = 'Test Email via Mailpit';
$mail->Body = 'This is a test email sent to Mailpit.';
$mail->send();
echo 'Message has been sent';
} catch (Exception $e) {
echo "Message could not be sent. Mailer Error: {$mail->ErrorInfo}";
}
在此代码中,$mail->Host 设置为 'localhost',$mail->Port 设置为 1025。这与 MailHog 的配置完全相同,因此如果之前的代码能连接到 MailHog,只需确认端口无误即可无缝切换到 Mailpit。若之前使用了 sendmail 驱动,则需要改为 isSMTP() 并指定上述主机和端口。
Mailpit 的 Web 界面有哪些新增功能
Mailpit 的 Web 界面基于现代前端技术构建,相比 MailHog 提供了更好的用户体验和功能。主要新增功能包括:支持搜索和过滤邮件、显示完整的 MIME 结构、提供 HTML 邮件预览、以及导出邮件为 EML 文件。这些功能使得排查邮件格式问题和调试复杂邮件内容变得更加容易。
访问 http://localhost:8025 即可看到 Mailpit 的仪表盘。左侧栏列出所有收到的邮件,点击某封邮件可在右侧查看详细信息,包括原始 MIME 内容、HTML 渲染效果以及附件。搜索框支持按发件人、收件人、主题等字段进行实时过滤。此外,Mailpit 还支持通过 API 获取邮件数据,便于集成到自动化测试流程中。


















