Composer事件回调拿不到$event参数是因为监听器函数签名不匹配，必须且仅接收一个$event参数，类型为Event或其子类；注册格式须为"post-install-cmd": "MyNamespace\MyClass::myHandler"，旧格式已废弃。
Composer事件回调里拿不到$event参数？检查监听器签名是否匹配
Composer事件监听器函数必须接收且仅接收一个$event参数，类型为ComposerEventDispatcherEvent或其子类（如ScriptEvents::POST_INSTALL_CMD触发的是CommandEvent）。如果函数没声明参数，或写了两个以上参数，PHP会静默忽略该监听器——不会报错，但$event永远为空。
- 正确写法：
function myHandler($event) { ... } - 错误写法：
function myHandler() { ... }（无参）或function myHandler($a, $b) { ... }（多参） - 在
composer.json中注册时，确保格式为"post-install-cmd": "MyNamespace\MyClass::myHandler"，不是"post-install-cmd": ["MyNamespace\MyClass", "myHandler"]（后者是旧版写法，已废弃且不传$event）
想读取当前安装的包列表或命令行选项？用$event->getArguments()和$event->getIO()
$event对象本身不直接暴露包列表或--no-dev这类标志，得靠它携带的上下文对象。不同事件类型返回的$event子类不同：命令类事件（如post-install-cmd）是CommandEvent，能拿到原始参数；而包安装类事件（如post-package-install）是PackageEvent，提供getOperation()和getPackage()。
-
$event->getArguments()返回array，含composer install后面的所有参数（如['--no-dev', '--optimize-autoloader']） -
$event->getIO()->isVerbose()判断是否加了-v，比自己解析$argv可靠 -
$event instanceof ComposerEventDispatcherScriptEvent是最宽泛的类型判断，但实际开发中应按具体事件类型做instanceof细分
在post-autoload-dump里访问自动加载映射？别直接读vendor/autoload.php，用$event->getDumpAutoloads()
这个事件触发时，Composer刚生成完新的autoload_files.php等文件，但vendor/autoload.php还没重写完毕。此时若手动require它，可能加载旧缓存或报错。官方提供了安全接口。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
$event->getDumpAutoloads()返回ComposerAutoloadAutoloadGenerator实例，可调用getClassesToLoad()、getFilesToLoad()等方法获取当前生成的映射 - 避免
file_get_contents('vendor/composer/autoload_classmap.php')——该文件可能尚未写入磁盘，或格式未稳定 - 如果要修改生成逻辑（比如加自定义加载规则），应在
Plugin中实现activate()并监听PRE_AUTOLOAD_DUMP，而非在post-autoload-dump里硬改
调试时var_dump($event)输出太长？优先查getEventType()和getName()
Composer事件对象嵌套深、属性多，直接var_dump容易淹没关键信息。真正影响逻辑的只有三样东西：事件类型、触发来源、可用上下文方法。
立即学习“PHP免费学习笔记（深入）”；
-
$event->getEventType()返回字符串，如"post-install-cmd"，确认你监听的是预期事件 -
$event->getName()在CommandEvent中同getEventType()，但在PackageEvent中返回操作名（如"install"或"update"） - 不要依赖
print_r($event)看私有属性——很多关键数据被封装在protected属性里，需通过公开方法获取
事件上下文不是全局状态，每次触发都是新对象；想跨事件共享数据，得自己用file_put_contents()临时落盘或走环境变量，别指望$event能记住上次的事。
