Ubuntu服务器Laravel加载Postfix/Dovecot邮件的技术问询

一、能不能在Laravel中加载/var/mail下的普通邮件文件？当然可以！ #

你完全可以在Laravel应用中读取并解析这些存储在/var/mail目录里的邮件文件，不需要从零开始写解析器——有现成的工具和库能帮你搞定。

1. 必备的PHP扩展：Mailparse #

首先得安装mailparse扩展，它是PHP官方提供的专门用于解析MIME格式邮件的工具，能帮你轻松提取邮件的主题、发件人、收件人、正文（包括HTML和纯文本）、附件等内容。

在Ubuntu服务器上安装的话，根据你的PHP版本执行对应的命令：

# 比如PHP 8.2版本
sudo apt-get install php8.2-mailparse

安装完成后重启PHP-FPM或者Apache/Nginx服务即可生效。

2. 可用的Laravel库或实现方式 #

你可以选择两种路径：

• 自定义解析类：基于Mailparse扩展封装一个Laravel服务类，逻辑很简单：读取/var/mail下的文件内容，用Mailparse解析成可操作的对象，提取你需要的字段。比如写一个MailFileReader类，里面包含parseFile($path)方法，返回解析后的邮件数据。
• 现成的Laravel包：推荐使用webklex/laravel-imap，虽然它主要是用来处理IMAP协议的邮箱，但也支持读取本地的mbox格式邮件文件（/var/mail下的文件就是标准mbox格式）。你只需要在配置文件里指定本地邮箱文件的路径，就能直接用它的API来获取邮件列表和详情，省掉自己写解析逻辑的麻烦。

配置示例大概是在config/imap.php里设置：

'accounts' => [
    'default' => [
        'host' => 'localhost',
        'port' => 0,
        'protocol' => 'mailbox', // 指定用本地邮箱文件协议
        'username' => '',
        'password' => '',
        'validate_cert' => false,
        'mailbox' => '/var/mail/your_username', // 你的邮件文件路径
        'folder' => 'INBOX',
    ],
],

然后就可以在控制器里调用：

use Webklex\IMAP\Facades\Client;

$client = Client::account('default');
$client->connect();
$messages = $client->getFolder('INBOX')->messages()->all()->get();

foreach ($messages as $message) {
    echo $message->getSubject();
    echo $message->getFrom();
    echo $message->getHTMLBody();
}

二、能不能将邮件存储到数据库以便更便捷加载？必须可以！ #

把邮件存入数据库绝对是更优的方案，尤其是你只需要加载和展示的场景——数据库查询比直接读取和解析文件快得多，也更容易做分页、搜索、分类等操作。

实现步骤： #

1. 创建数据库表
   生成一个emails表的迁移文件：

php artisan make:migration create_emails_table

然后在迁移文件里定义字段：

public function up()
{
    Schema::create('emails', function (Blueprint $table) {
        $table->id();
        $table->string('subject')->nullable();
        $table->string('from_address');
        $table->string('from_name')->nullable();
        $table->text('to_addresses'); // 存储多个收件人，用JSON或者字符串分隔
        $table->text('body_html')->nullable();
        $table->text('body_text')->nullable();
        $table->text('raw_content')->nullable(); // 可选，存储原始邮件内容，方便后续回溯
        $table->timestamp('received_at')->nullable();
        $table->timestamps();
    });
}

执行迁移：php artisan migrate

2. 创建Eloquent模型
   生成对应的模型：

php artisan make:model Email

3. 编写解析并入库的逻辑
   你可以写一个Artisan命令，或者定时任务（比如用Laravel的Schedule），定期扫描/var/mail目录下的邮件文件，解析后存入数据库。比如：

• 读取/var/mail下的文件内容（注意：/var/mail下的文件通常是每个用户一个mbox文件，里面包含该用户的所有邮件）
• 用Mailparse或者webklex/laravel-imap解析每一封邮件
• 检查该邮件是否已经存入数据库（可以通过原始内容的哈希或者邮件ID来判断，避免重复入库）
• 将解析后的字段存入emails表

示例命令的核心逻辑：

// 假设用webklex的包来解析
$client = Client::account('default');
$client->connect();
$messages = $client->getFolder('INBOX')->messages()->unseen()->get(); // 可以只处理未入库的邮件

foreach ($messages as $message) {
    // 检查是否已存在
    $exists = Email::where('raw_content', $message->getRaw())->exists();
    if (!$exists) {
        Email::create([
            'subject' => $message->getSubject(),
            'from_address' => $message->getFrom()->first()->getAddress(),
            'from_name' => $message->getFrom()->first()->getName(),
            'to_addresses' => json_encode($message->getTo()->pluck('address')->toArray()),
            'body_html' => $message->getHTMLBody(),
            'body_text' => $message->getTextBody(),
            'raw_content' => $message->getRaw(),
            'received_at' => $message->getDate(),
        ]);
    }
}

4. 在Laravel中展示邮件
   现在你就可以直接用Eloquent模型查询邮件了，比如在控制器里：

use App\Models\Email;

public function index()
{
    $emails = Email::orderBy('received_at', 'desc')->paginate(10);
    return view('emails.index', compact('emails'));
}

然后在视图里循环展示邮件列表和详情即可。

内容的提问来源于stack exchange，提问作者Arash Hatami