模型事件必须在 protected static init() 中调用 self::event() 显式注册才生效,如 self::event('after_insert', ...);漏注册或未在 init() 中执行则钩子不触发,且子类需手动调 parent::init() 继承父类事件。

监听器和模型事件是两套独立机制,不能混用:监听器靠 event() 触发、需手动注册;模型事件是模型生命周期钩子,自动触发、必须在 init() 中注册。
模型事件怎么注册才生效
模型事件不是写完函数就自动运行的,必须显式调用 self::event() 注册,且只能在 init() 静态方法里做。漏掉这一步,before_insert、after_update 这些钩子全都不执行。
-
init()必须是protected static,不能是public或实例方法 - 注册时传入的回调函数接收一个参数:
$model(当前模型实例),不是原始数组或请求数据 - 多个事件要分别注册,
self::event('after_insert', ...)和self::event('after_update', ...)不能合并 - 基类中注册的事件,子类会继承,但若子类也定义了
init(),必须手动调用parent::init(),否则父类事件丢失
监听器为什么写了却没反应
监听器不依赖模型操作,但依赖三件事:类存在、配置注册、正确触发。常见失效原因是只做了其中一环。
- 监听类必须放在
app\listener\目录下,命名空间为app\listener,类名首字母大写(如UserLoginListener) - 必须在
app\event.php的listen数组里配对,键是事件名(如'user_login'),值是完整类名数组:['app\listener\UserLoginListener'] - 触发必须用
event('user_login', $data),不能用Event::trigger()(TP6+ 已废弃)或直接 new 类 - 监听类的
handle()方法签名必须是public function handle($event),参数名无所谓,但类型是触发时传入的整个数据包
模型事件里能直接调 HTTP 吗
能,但非常危险——after_save 或 after_delete 里发同步请求,容易拖垮主流程,尤其遇上 ES、短信网关这类不稳定服务。
- 事务未提交前触发的事件(如
before_write),HTTP 失败会导致业务中断;事务已提交后触发(如after_insert),HTTP 失败又无法回滚数据库 -
saveAll()批量操作只触发一次事件,但你要同步 N 条记录,得在回调里手动遍历$model->data或查库补全 - 推荐做法:事件里只投递任务 ID 到队列(如
think-queue),由 Worker 异步执行同步逻辑,失败可重试、可监控 - 若真要同步调,务必加超时(
curl_setopt($ch, CURLOPT_TIMEOUT_MS, 500))和 try/catch,失败记日志但绝不 throw
模型事件拿不到请求参数怎么办
$model 实例本身不携带 $_GET、$_POST 或路由参数,得自己取。别硬塞全局变量,也别在控制器里传参进 save() —— 模型事件不接收第二个参数。
- 用
Request::instance()获取当前请求对象,再调param()、url()、ip() - 想取 GUID/UUID 这类业务标识,优先从
$model->getData()里找(如$model->guid),其次 fallback 到Request::instance()->param('guid') - 注意:
Request::instance()在命令行或队列任务中会返回空,此时需改用上下文传递(如通过think\facade\Cache临时存、事件里取) - Session 数据(如登录用户 ID)要用
Session::get('user_id'),但得确认 Session 驱动可用(文件驱动在 CLI 下不可用)
模型事件看似简单,真正难的是状态一致性——比如日志写一半失败、ES 同步滞后、事务与外部服务错位。这些细节不会报错,但上线后查数永远对不上。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











