如何在 Laravel 与 Lumen 共享数据库场景下跨项目处理事件

本文介绍一种无需重复定义事件与监听器、基于队列驱动的跨项目事件处理方案：laravel 负责触发事件并分发为队列任务，lumen 作为独立工作进程消费该任务，实现松耦合的微服务协作。

在 laravel 与 Lumen 共享同一数据库的微服务架构中，直接复用 Laravel 的事件系统（Event::dispatch() + Listener）并不可行——因为 Lumen 默认不启用事件服务容器绑定，且事件类与监听器无法跨项目自动识别。强行同步代码不仅违反单一职责原则，还会导致维护成本陡增。

✅ 正确解法是将业务逻辑下沉至队列任务（Job），利用两者共用的数据库 jobs 表实现通信：

1. Laravel 端：将事件转化为可分发的队列任务
   不注册监听器，而是创建一个轻量级 Job 类（如 LogredirectJob），并在事件触发时直接分发它：

// app/Jobs/LogRedirectJob.php url = $url;         $this->referrer = $referrer;     }      public function handle()     {         // 此处仅作调度，实际处理由 Lumen 执行         // 或留空，由 Lumen 完全接管     } }

然后在 Laravel 中触发事件时分发该 Job：

// 在控制器或服务中 LogRedirectJob::dispatch($request->url, $request->header('Referer'))     ->onConnection('database') // 明确使用 DB 驱动     ->onQueue('redirects');     // 指定队列名，便于 Lumen 专注监听

2. Lumen 端：配置队列并编写处理器
   确保 bootstrap/app.php 中已启用队列服务：

$app->withFacades(); $app->withEloquent();  // 启用队列 $app->register(IlluminateQueueQueueServiceProvider::class); $app->configure('queue');  // 可选：绑定自定义队列连接（若需区分） $app->configure('database');

创建对应 Job 类（路径建议与 Laravel 一致，如 app/Jobs/LogRedirectJob.php），关键点在于：Lumen 中的 Job 类只需包含 handle() 方法，无需继承或实现复杂接口（Lumen 8+ 支持原生 Laravel Job 结构）：

// lumen-app/app/Jobs/LogRedirectJob.php url = $url;         $this->referrer = $referrer;     }      public function handle()     {         DB::table('redirect_logs')->insert([             'url' => $this->url,             'referrer' => $this->referrer,             'created_at' => now(),         ]);     } }

3. 运行 Lumen 队列监听器
   在 Lumen 项目根目录执行（确保 .env 中 QUEUE_CONNECTION=database）：

php artisan queue:work --queue=redirects --sleep=3 --max-jobs=100

✅ 优势总结： 零代码冗余：事件类、Job 类可独立维护；Laravel 不需知道 Lumen 的存在，反之亦然； 强健性提升：失败任务进入 failed_jobs 表，支持重试与人工干预； 扩展友好：未来可轻松切换为 redis、SQS 等队列驱动，无需修改业务逻辑； 符合微服务契约：Laravel 是“发布者”，Lumen 是“订阅-处理器”，职责清晰。

⚠️ 注意事项：

• 确保两个项目 APP_KEY 不同（安全所需），但 QUEUE_CONNECTION 和数据库凭证必须一致；
• 若使用 SerializesModels，模型需在两个项目中结构完全兼容（推荐传输原始数据而非 Eloquent 实例）；
• 生产环境建议为 Lumen 单独部署 Supervisor 进程管理队列消费者。