Yii事件机制需显式绑定和触发，常见问题包括事件名拼错、未继承yii\base\Event、硬编码不声明常量；安全做法是定义事件常量、正确绑定（实例或全局）、触发时传入合法事件对象。
Yii 的事件机制不是“写了就能跑”，必须显式绑定 + 显式触发，缺一不可；事件名拼错、没继承 yii\base\Event、用字符串硬编码不声明常量——这三类问题占了 80% 的调试时间。
怎么在模型里安全绑定和触发自定义事件
绑定前必须先在目标类（如 Order）中定义事件常量，例如：const EVENT_AFTER_PAY = 'afterPay';。不声明也能运行，但 IDE 找不到跳转、重构时容易断，不推荐。
- 绑定只对当前实例生效：
$order->on(Order::EVENT_AFTER_PAY, function ($event) { ... }); - 全局绑定要用
Event::on()静态方法，第一个参数必须是类名字符串（Order::class），不能传对象 - 触发必须调用
trigger()，且传入的事件对象要继承yii\base\Event，比如：$this->trigger(self::EVENT_AFTER_PAY, new OrderEvent(['order' => $this])); - 常见静默失败：事件名大小写不一致（
'afterpay'≠'afterPay'）、trigger()没写在业务逻辑路径里、监听器方法不是public
为什么用行为（Behavior）方式注册事件更稳妥
行为能自动挂载到组件生命周期中，适合做统一拦截（比如所有请求前记录 IP、所有模型保存后发通知），避免手动在每个控制器/模型里重复 on()。
- 行为类需继承
yii\base\Behavior，并在events()方法中返回映射数组：[Application::EVENT_BEFORE_REQUEST => 'logRequest'] - 行为中触发自定义事件，要用
Yii::$app->trigger(...)或目标组件实例的trigger()，不能直接用$this->trigger()（$this是行为对象，不是组件） - 配置行为时注意语法：
'as myBehavior' => MyBehavior::class，键名带as前缀，否则不会自动挂载 - 行为里写的事件处理器，若依赖请求上下文（如
Yii::$app->request），确保行为挂载时机早于实际使用，否则可能为null
Event::on() 全局监听要注意内存泄漏和执行顺序
全局监听绕过对象生命周期，handler 一旦注册就一直驻留内存，尤其在 CLI 脚本或长连接服务中极易累积泄漏。
- 必须配对使用
Event::off()解绑，测试时建议在tearDown()里统一清理 - 多个模块都调
Event::on()同一个事件，执行顺序按注册先后，无法保证；需要强顺序控制时，应改用消息队列或自定义事件总线 - 不支持类似
beforeSave/afterSave的钩子链，trigger()是一次性广播，没有拦截或中断能力 - 优先级参数（第 5 个参数）只影响同一次
Event::on()调用中的多个 handler 排序，跨调用无效
自定义事件类为什么必须继承 yii\base\Event
不继承也能触发，但会丢失关键能力：无法携带数据、无法被事件管理器识别为合法事件对象、$event->name 和 $event->sender 为空。
- 最简定义只需一行：
class OrderEvent extends \yii\base\Event { public $order; } - 字段命名别用下划线（如
$order_id），PHP 属性访问是驼峰，$event->orderId更自然 - 如果只是传 ID 或状态码，也建议继承——它成本极低，但能避免后期加字段时重构整个事件调用链
- 不要在事件类里放业务逻辑或 heavy 初始化，事件对象应轻量、无副作用
最容易被忽略的是：事件名声明、绑定、触发三处必须完全一致，包括大小写和下划线风格；还有就是全局监听后忘了 Event::off()，上线后内存缓慢上涨，日志看不出异常，查起来特别费时间。
