在 Yii 模型中安全绑定自定义事件需先定义事件常量（如 const EVENT_AFTER_PAY = 'afterPay';），再用 on() 绑定监听器；触发时必须显式调用 trigger() 并传入继承自 yii\base\Event 的事件对象，全局监听应使用 Event::on() 但需注意内存泄漏和手动解绑。
怎么在 Yii 模型里安全绑定自定义事件
Yii 的事件不是靠字符串硬编码注册的，而是依赖 on() 方法 + 事件名常量或字符串，但必须确保事件名和触发点对得上。最常见错误是绑定了事件，却没在对应类里声明它，导致静默失效。
- 必须先在目标类（如
ActiveRecord子类）中定义事件常量，比如const EVENT_AFTER_PAY = 'afterPay'; - 绑定时用
on()，支持闭包、数组回调、匿名函数：$order->on(Order::EVENT_AFTER_PAY, function ($event) { \Yii::info('Payment confirmed', 'order'); }); - 如果用字符串事件名（如
'afterPay'），不声明常量也能工作，但 IDE 无法跳转、重构易出错，不推荐 - 注意：绑定只对当前对象实例有效；若想全局生效（比如所有
Order实例），要用Event::on()静态方法
触发事件时为什么没执行监听器
90% 的“没触发”问题出在事件名拼写不一致、作用域错位，或者忘了调用 trigger() —— Yii 不会自动扫描方法名来发事件。
- 触发必须显式调用
trigger()，且参数必须和绑定时一致：$this->trigger(self::EVENT_AFTER_PAY, new OrderEvent(['order' => $this]));
- 事件对象（如
OrderEvent）要继承yii\base\Event，否则无法携带额外数据 - 如果监听器是类方法（
['OrderService', 'handlePay']），确保该类已加载、方法是 public、且无构造依赖未满足 - 开发期可临时加
\Yii::debug('firing ' . self::EVENT_AFTER_PAY);确认是否走到trigger()行
用 Event::on() 全局监听要注意什么
全局监听适合跨模块响应（比如支付成功后发短信、更新库存），但它绕过实例生命周期，容易引发内存泄漏或重复绑定。
- 绑定语法是
Event::on(ClassName::class, ClassName::EVENT_X, $handler)，第一个参数必须是类名字符串，不能是对象 - 必须手动解绑（
Event::off()），尤其在测试或长生命周期脚本中，否则 handler 一直驻留内存 - 多个模块都调
Event::on()同一事件，handler 执行顺序按注册先后，不可靠；需要确定顺序时，改用事件总线或消息队列 - 不支持
beforeEvent/afterEvent这类钩子——Yii 原生只有trigger()一次广播，没有拦截链
自定义事件类要不要继承 yii\base\Event
要。哪怕只是传个 ID，也建议继承。直接传数组或 stdClass 会导致后续扩展困难，且无法利用 Yii 事件系统的 data、name、handled 等标准字段。
- 最小化定义：
class OrderEvent extends \yii\base\Event { public $order; public $amount; } - 触发时传入这个对象，监听器就能直接访问
$event->order->id，而不是从$event->data里硬解包 - 如果事件需被中断（比如权限校验失败就阻止后续操作），设
$event->handled = true，但注意：Yii 默认不检查这个字段，得自己在业务逻辑里判断 - 别为了“轻量”用数组代替事件类——调试时 var_dump 一堆嵌套数组，比看一个有属性提示的对象痛苦得多
实际项目里最容易漏的是：在 console 应用或异步任务里忘记重连事件监听，或者把 trigger() 写在事务 commit 之前，结果事务回滚了但事件已经发出去。这些点没有报错，但行为和预期差很远。
