第27章 Flarum 邮件配置指南

版本：2.x邮件配置

任何社区都需要发送邮件，用于邮箱验证、密码重置、向用户发送通知及其他沟通。作为管理员，配置论坛发邮件应当是头等大事之一：配置出错会导致用户注册时出现错误。

可用驱动

Flarum 默认提供了几种邮件驱动，如下所列并附有说明。开发者也可以通过扩展添加自定义邮件驱动。

SMTP

这可能是最常用的邮件驱动，允许你为外部 SMTP 服务配置主机、端口/加密方式、用户名和密码。注意：加密字段只能填 ssl 或 tls。

Mail

Mail 驱动会尝试使用许多主机服务器自带的 sendmail / postfix 邮件系统。你需要先在服务器上正确安装并配置 sendmail 才能使用。

Mailgun

此驱动通过你的 Mailgun 账户发送邮件。你需要一个 secret key，以及 Mailgun 配置中的 domain 和 region。

要使用 Mailgun 驱动，需要安装 Guzzle composer 包（一个 PHP HTTP 客户端）。在 Flarum 安装根目录运行 composer require guzzlehttp/guzzle:^6.0|^7.0 即可。

Log

Log 邮件驱动不会真正发送邮件，主要供开发者使用。它会将邮件内容写入 FLARUM_ROOT_DIRECTORY/storage/logs 下的日志文件。

测试邮件

保存邮件配置后，可以点击管理后台 Mail 页面上的"发送测试邮件"按钮，确认配置是否有效。如果出现错误或收不到邮件，请调整配置后重试。如果没有报错但收件箱里没有邮件，记得检查一下垃圾邮件文件夹。