自定义Eloquent事件需通过$dispatchesEvents绑定真实事件类并由模型实例方法（如save）触发，DB::table或静态调用static::saved不生效；业务事件如OrderPaid须手动event()触发，且事件类构造函数宜传ID而非模型实例。
自定义 Eloquent 事件不是靠“注册监听器”就能生效的——必须显式触发，且仅对 save()、create()、update() 等 Eloquent 原生方法有效，DB::table() 或原生 SQL 完全不触发。
怎么声明和触发自定义模型事件
在模型中通过 $dispatchesEvents 属性绑定事件名到自定义事件类，Laravel 不会自动识别任意字符串，必须是真实存在的 PHP 类（通常继承 Illuminate\Database\Eloquent\Event）。
常见错误：写成 'custom_saved' => 'App\Events\CustomSaved' 却没创建该类，或类名拼错导致静默失败；更隐蔽的是用了 static::saved() 这类静态调用——它不会触发 $dispatchesEvents 映射的事件。
-
$dispatchesEvents只支持creating、created、updating、updated、saving、saved等内置事件名作为键，不能随便写'order_paid' => ... - 若要触发业务事件（如
OrderPaid），需在模型中手动调用event(new OrderPaid($this))，并确保该事件类不含数据库操作（避免事务冲突） - 自定义事件类本身不需要实现任何接口，但构造函数参数应尽量轻量，避免传整个模型实例（可只传 ID）
为什么 static::saved() 不触发你的自定义事件
因为 static::saved() 是 Laravel 的「观察者风格」静态监听入口，它只分发内置事件，与 $dispatchesEvents 无关。它本质是 Event::listen('eloquent.saved: App\Models\Order', ...) 的语法糖，不走模型实例的事件分发流程。
立即学习“PHP免费学习笔记（深入）”；
真正触发 $dispatchesEvents 的，只有模型实例调用 save()、update()、delete() 等方法时内部调用的 $this->fireModelEvent()。
- 用
Order::where(...)->update([...])—— 不触发任何模型事件（包括自定义） - 用
Order::find(1)->update([...])—— 触发updating+updated，进而触发$dispatchesEvents中对应项 - 想统一处理，就别混用批量更新和实例更新；业务关键逻辑必须落在实例操作路径上
在事件监听器里访问模型数据要注意什么
监听器收到的事件对象（比如 OrderPaid）如果是在模型 saved 钩子中 event(new OrderPaid($order)) 发出的，那它持有的是保存后的模型快照；但如果监听器里又去查 Order::find($id)，可能拿到脏数据（比如事务未提交）。
- 监听器默认在「事件循环」中异步执行（除非你禁用队列），但仍是同步 PHP 流程，共享当前请求的数据库连接
- 不要在监听器里调用
$model->fresh()或reload()—— 模型状态已是最新的，重载反而可能绕过事务隔离 - 涉及多表关联更新（如扣库存 + 记日志），优先用数据库事务包裹原始操作，而不是靠事件“补救”；事件更适合通知、缓存失效、发消息等副作用
最常被忽略的一点：自定义事件类的构造函数参数若包含模型实例，在队列环境下会被序列化，可能触发隐式加载关系（$model->user），导致 N+1 或序列化失败。传 ID 最安全。
