0

0

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

尼克

尼克

发布时间:2026-01-01 19:48:09

|

734人浏览过

|

来源于php中文网

原创

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

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

直接说结论: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 方法。

特别注意两个易错点:

千图设计室AI海报
千图设计室AI海报

千图网旗下的智能海报在线设计平台

下载
  • 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 字样。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

1998

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1324

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1228

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

948

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1402

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1229

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1440

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1303

2023.11.13

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

65

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.2万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号