新闻中心 分类>>

Laravel怎么实现观察者模式Observer_Laravel模型事件监听与解耦开发【指南】

2026-01-01 00:00:00
浏览次数:
返回列表
Laravel的观察者模式本质是模型事件的封装机制,Observer类通过反射将静态方法映射到对应生命周期钩子,依赖dispatchesEvents或自动注册机制触发,不监听任何东西。

直接说结论:Laravel 的「观察者模式」本质是模型事件(Model Events)的封装机制,Observer 类本身不监听任何东西,它只是把一堆 static 方法映射到对应模型生命周期钩子上——真正起作用的是 dispatchesEvents 或自动注册机制。

Observer 是怎么被 Laravel 自动调用的?

Laravel 不靠 PHP 的 SPL 观察者,而是靠模型事件分发 + 反射调用。当你执行 php artisan make:observer UserObserver --model=User,生成的类里每个方法名(如 createdupdated)必须和模型支持的事件名完全一致,且首字母小写。

关键点在于注册方式:

  • 手动注册:在 AppServiceProvider::boot() 里调用 User::observe(UserObserver::class)
  • 自动注册(Laravel 9+):只要在 boot() 中调用 Observes::register() 并传入模型与观察者映射,或使用 EventServiceProvider$observe 属性(推荐)
  • 注意:观察者方法接收的是模型实例,不是事件对象;没有 $event 参数

哪些模型事件能被 Observer 捕获?

只有 Eloquent 定义的 10 个标准事件可用,比如 creatingcreatedupdatingupdatedsavingsaved 等。自定义事件(如 user.login)不会触发 Observer 方法。

特别注意两个易错点:

  • creatingcreated 区别:前者在写入数据库前(可修改属性、返回 false 中断保存),后者在插入成功后(已含 id,但事务未提交)
  • retrieved 仅在首次从数据库取数据时触发,Eager loading 关系数据不会触发它
  • deleting 阶段还能访问模型关联数据;deleted 阶段关联可能已释放(取决于是否用了 withTrashed()

Observer 和 Model Events 直接监听的区别?

Observer 是语法糖,底层仍走 Event::dispatch()。但二者注册位置和优先级不同:

use Illuminate\Database\Eloquent\Model;

// 方式一:在模型内硬编码(不推荐)
protected $dispatchesEvents = [
    'created' => UserCreated::class,
];

// 方式二:全局监听(更灵活,支持队列、中间件)
Event::listen(UserCreated::class, function (UserCreated $event) {
    // ...
});

// 方式三:Observer(语义清晰,适合同域逻辑)
class UserObserver
{
    public function created(User $user)
    {
        // 同步发邮件、记录日志等轻量操作
        Mail::to($user)->send(new WelcomeMail());
    }
}

性能提示:

  • Observer 方法默认同步执行,若含 HTTP 请求、文件写入或耗时 DB 查询,应改用事件 + 队列
  • 多个 Observer 注册同一模型时,按注册顺序执行,无内置优先级控制
  • 如果在 saving 中修改了模型字段,需手动调用 $model->setDirty('field') 才会真正更新到数据库

为什么 Observer 方法没执行?常见排查路径

不是代码写错了,大概率是注册漏了或时机不对:

  • 检查是否在 AppServiceProvider::boot() 中调用了 Model::observe(Observer::class),且该调用不在 if (app()->runningInConsole()) 分支里(否则 Web 请求不生效)
  • 确认模型没有设置 protected $dispatchesEvents = [] 清空了默认事件映射
  • 运行 php artisan tinker,手动触发一次 User::create([...]),看是否报错或静默失败
  • 观察者方法名拼写错误(如写成 CreatedonCreated)——Laravel 不会警告,直接跳过
  • 使用了 DB::table('users')->insert(...):绕过了 Eloquent,Observer 完全不触发

最常被忽略的一点:Observer 只响应模型类自身的操作。如果你在 Repository 或 Service 里 new 了一个模型但没调用 save(),或者用了 updateOrCreate() 却忘了它内部仍走 Eloquent 生命周期——这些都得实测验证,不能只看代码有没有 save 字样。

搜索