0

0

Laravel如何使用模型观察者?(Observer代码示例)

穿越時空

穿越時空

发布时间:2025-12-24 12:56:02

|

424人浏览过

|

来源于php中文网

原创

Laravel模型观察者用于解耦生命周期逻辑,适用于日志记录、缓存同步等场景;通过php artisan make:observer生成并注册,支持retrieved、creating、created等10个事件方法。

laravel如何使用模型观察者?(observer代码示例)

在 Laravel 中,模型观察者(Observer)用于监听模型的生命周期事件,比如创建、更新、删除等操作,把相关逻辑从控制器或模型中解耦出来,让代码更清晰、可维护性更强。

什么时候该用 Observer?

当你需要在模型保存前/后自动执行某些操作时,比如:记录日志、同步缓存、发送通知、生成缩略图、更新关联统计字段等。比起在模型的 boot() 里写一堆 creatingsaving 回调,Observer 更结构化、易测试、也更容易复用。

如何创建和注册 Observer?

使用 Artisan 命令快速生成:

php artisan make:observer UserObserver --model=User

这会在 app/Observers 下生成 UserObserver.php,并在 AppServiceProviderboot() 方法中注册它:

app/Providers/AppServiceProvider.php 中添加:

use App\Models\User;
use App\Observers\UserObserver;

然后在 boot() 方法里写:

《PHP设计模式指南》中文版
《PHP设计模式指南》中文版

《PHP设计模式》首先介绍了设计模式,讲述了设计模式的使用及重要性,并且详细说明了应用设计模式的场合。接下来,本书通过代码示例介绍了许多设计模式。最后,本书通过全面深入的案例分析说明了如何使用设计模式来计划新的应用程序,如何采用PHP语言编写这些模式,以及如何使用书中介绍的设计模式修正和重构已有的代码块。作者采用专业的、便于使用的格式来介绍相关的概念,自学成才的编程人员与经过更多正规培训的编程人员

下载
User::observe(UserObserver::class);

Observer 支持哪些方法?

默认支持以下 10 个方法(对应 Eloquent 事件),只需实现你关心的即可:

  • retrieved — 模型从数据库查出后触发(每次 getfirst 等都会)
  • creatingsave()create() 前触发(尚未写入 DB)
  • created — 成功插入数据库后触发
  • updating — 更新前触发($user->save()$user->update()
  • updated — 更新成功后触发
  • saving — 创建或更新前统一触发(比 creating/updating 更早)
  • saved — 创建或更新成功后统一触发
  • deleting — 删除前触发
  • deleted — 删除成功后触发
  • restoring / restored — 软删除模型恢复时触发(需模型启用软删除)

一个实用的 Observer 示例

假设有个 User 模型,希望在用户创建时自动生成唯一邀请码,并在更新邮箱时清除旧邮箱缓存:

app/Observers/UserObserver.php
namespace App\Observers;

use App\Models\User;
use Illuminate\Support\Str;

class UserObserver
{
    public function creating(User $user)
    {
        if (empty($user->invite_code)) {
            $user->invite_code = Str::random(8);
        }
    }

    public function updated(User $user)
    {
        if ($user->isDirty('email')) {
            cache()->forget('user_email_' . $user->getOriginal('email'));
        }
    }

    public function deleted(User $user)
    {
        // 可选:软删除时清理关联数据,如头像文件
        if ($user->avatar) {
            \Storage::disk('public')->delete($user->avatar);
        }
    }
}

注意:isDirty('email') 判断字段是否被修改,getOriginal('email') 获取变更前的值,这对缓存清理很关键。

基本上就这些。Observer 不复杂但容易忽略细节,比如事件触发时机、是否支持软删除、以及避免在 observer 里做耗时操作(必要时应 dispatch job)。用对了,模型层会干净很多。

相关专题

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

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

1641

2023.09.01

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

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

1080

2023.10.11

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

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

982

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数据库相关内容,可以阅读本专题下面的文章。

1396

2023.10.23

html怎么上传
html怎么上传

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

1226

2023.11.03

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

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

1437

2023.11.09

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

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

1302

2023.11.13

苹果官网入口直接访问
苹果官网入口直接访问

苹果官网直接访问入口是https://www.apple.com/cn/,该页面具备0.8秒首屏渲染、HTTP/3与Brotli加速、WebP+AVIF双格式图片、免登录浏览全参数等特性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

10

2025.12.24

热门下载

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

精品课程

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

共137课时 | 7.7万人学习

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

共6课时 | 6.9万人学习

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

共13课时 | 0.8万人学习

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

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