讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

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

浅晨姑娘_7636

浅晨姑娘_7636

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

|

774人浏览过

|

来源于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,生成的类里每个方法名(如 created、updated)必须和模型支持的事件名完全一致,且首字母小写。

关键点在于注册方式:

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

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

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

特别注意两个易错点:

Laravel Cloud
Laravel Cloud

Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。

下载
  • creating 和 created 区别:前者在写入数据库前(可修改属性、返回 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([...]),看是否报错或静默失败
  • 观察者方法名拼写错误(如写成 Created 或 onCreated)——Laravel 不会警告,直接跳过
  • 使用了 DB::table('users')->insert(...):绕过了 Eloquent,Observer 完全不触发

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

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

897

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

875

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2528

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

4981

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

7330

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

4816

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

9009

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

1536

2026.03.04

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn