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

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

在 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() 方法里写:

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  # laravel  # vite  # app  # ai  # 邮箱  # red  #   # class  # 事件  # 数据库  # 并在  # 有个  # 什么时候  # 当你  # 只需  # 适用于  # 这对  # 可选  # 更强  # 这会 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 如何在阿里云虚拟主机上快速搭建个人网站?  东莞专业网站制作公司有哪些,东莞招聘网站哪个好?  android nfc常用标签读取总结  微信小程序 配置文件详细介绍  用yum安装MySQLdb模块的步骤方法  Laravel如何连接多个数据库_Laravel多数据库连接配置与切换教程  装修招标网站设计制作流程,装修招标流程?  作用域操作符会触发自动加载吗_php类自动加载机制与::调用【教程】  Laravel如何创建自定义中间件?(Middleware代码示例)  深圳网站制作的公司有哪些,dido官方网站?  如何在腾讯云服务器上快速搭建个人网站?  网站建设保证美观性,需要考虑的几点问题!  Laravel如何使用.env文件管理环境变量?(最佳实践)  高端建站三要素:定制模板、企业官网与响应式设计优化  Laravel Octane如何提升性能_使用Laravel Octane加速你的应用  Laravel如何与Inertia.js和Vue/React构建现代单页应用  Laravel怎么调用外部API_Laravel Http Client客户端使用  如何在阿里云服务器自主搭建网站?  LinuxShell函数封装方法_脚本复用设计思路【教程】  Laravel distinct去重查询_Laravel Eloquent去重方法  Laravel中DTO是什么概念_在Laravel项目中使用数据传输对象(DTO)  高防服务器:AI智能防御DDoS攻击与数据安全保障  Laravel Artisan命令怎么自定义_创建自己的Laravel命令行工具完全指南  Laravel怎么集成Log日志记录_Laravel单文件与每日日志配置及自定义通道【详解】  电视网站制作tvbox接口,云海电视怎样自定义添加电视源?  Python文件流缓冲机制_IO性能解析【教程】  Firefox Developer Edition开发者版本入口  专业企业网站设计制作公司,如何理解商贸企业的统一配送和分销网络建设?  如何在IIS中新建站点并配置端口与IP地址?  如何在云虚拟主机上快速搭建个人网站?  香港服务器建站指南:免备案优势与SEO优化技巧全解析  成都品牌网站制作公司,成都营业执照年报网上怎么办理?  DeepSeek是免费使用的吗 DeepSeek收费模式与Pro版本功能详解  EditPlus中的正则表达式实战(5)  Laravel怎么导出Excel文件_Laravel Excel插件使用教程  如何选择可靠的免备案建站服务器?  Python3.6正式版新特性预览  Laravel如何使用Facades(门面)及其工作原理_Laravel门面模式与底层机制  百度浏览器如何管理插件 百度浏览器插件管理方法  如何在宝塔面板中创建新站点?  Laravel如何安装使用Debugbar工具栏_Laravel性能调试与SQL监控插件【步骤】  如何获取上海专业网站定制建站电话?  EditPlus中的正则表达式 实战(2)  Laravel如何实现图片防盗链功能_Laravel中间件验证Referer来源请求【方案】  如何续费美橙建站之星域名及服务?  Laravel如何编写单元测试和功能测试?(PHPUnit示例)  Laravel怎么实现一对多关联查询_Laravel Eloquent模型关系定义与预加载【实战】  JavaScript如何操作视频_媒体API怎么控制播放  微信公众帐号开发教程之图文消息全攻略  零基础网站服务器架设实战:轻量应用与域名解析配置指南