EventManager::instance()->on() 是动态注册监听的正确写法，必须在事件触发前调用，推荐在 beforeFilter() 或 bootstrap() 中注册并加静态标记防重复，优先级用 priority 参数控制（数值越小越先执行）。
EventManager::instance()->on() 运行时绑定监听的正确写法
动态注册监听必须在事件触发前完成，且不能依赖类自动加载时机——比如在控制器 action 里调用 on() 是安全的，但在模型构造函数中过早调用可能导致监听未生效。
常见错误是把监听写在类定义体里（非方法内），导致只在类加载时执行一次，而那时 EventManager 实例可能还没初始化或上下文不完整。
- 监听必须用
EventManager::instance()->on('Some.eventName', ...)，不是new EventManager()->on(...) - 回调推荐用闭包或数组形式
[$object, 'methodName']，避免静态方法引用导致内存泄漏 - 事件名建议带命名空间前缀（如
'Model.Users.beforeSave'），避免全局冲突 - 如果绑定后没触发，先检查是否拼错了事件名——CakePHP 不报错，静默忽略不存在的事件
闭包监听里访问 $this 或服务对象的坑
在控制器中用闭包绑定事件时，直接写 function () use ($this) { ... } 会报错：PHP 不允许 use 引用 $this。这是语法限制，不是 CakePHP 的问题。
正确做法是提前提取所需属性或服务，再传入闭包：
立即学习“PHP免费学习笔记（深入）”；
// ✅ 正确：提取依赖
$userTable = $this->getTableLocator()->get('Users');
$logger = $this->getRequest()->getAttribute('logger');
EventManager::instance()->on('Model.Users.afterSave', function ($event, $entity) use ($userTable, $logger) {
$logger->info('User saved: ' . $entity->id);
});
- 不要在闭包里调用
$this->getTableLocator()—— action 执行完后控制器实例可能已销毁 - 若需调用模型方法，优先传入已实例化的表对象，而非类名字符串
- 闭包中修改
$entity是有效的（它传的是引用），但别试图改$event自身属性，CakePHP 不会回写
监听重复注册导致多次触发的问题
页面刷新或请求重放时，on() 被反复调用，监听器就堆叠了。一个事件触发，同一个闭包执行 3 次，日志刷屏、数据重复写入都是典型表现。
没有内置去重机制，得自己控制注册时机：
- 在
beforeFilter()或initialize()中注册，并加静态标记（如static $listenerAttached = false） - 更稳妥的做法是统一收口到应用启动阶段，在
src/Application.php的bootstrap()里绑定全局监听 - 临时调试可用
EventManager::instance()->off('Some.eventName')清掉旧监听，但生产环境慎用——可能误删其他模块注册的监听 - 用
EventManager::instance()->listeners('Some.eventName')查看当前绑定数，快速验证是否重复
监听器执行顺序与优先级控制
CakePHP 默认按注册顺序执行监听器，但有时需要前置或后置处理，比如日志监听必须在事务开启前，而清理缓存要在保存成功后。
通过 priority 参数调整顺序，数值越小越先执行（注意：不是越大越先）：
EventManager::instance()->on('Model.Users.afterSave', ['priority' => 10], $callbackA);
EventManager::instance()->on('Model.Users.afterSave', ['priority' => 5], $callbackB); // 先执行
- 默认 priority 是 10，设为 0 可确保最早执行，-100 是极限值（不建议低于 -50）
- priority 相同时，以注册先后为准；不同 priority 下，数字小的绝对优先
- 不要依赖 priority 做强耦合逻辑，比如“等另一个监听改完数据再处理”——应通过事件参数传递状态，而不是靠执行序
动态监听容易漏掉清理和优先级设计，尤其在插件或中间件里混用时。最麻烦的不是写不对，而是出问题时查不到谁注册了监听——建议所有运行时绑定都加注释说明用途和预期生命周期。
