Composer怎么编写事件监听插件_Composer如何监听Composer生命周期事件执行自定义逻辑【进阶】-composer-PHP中文网

composer 的事件监听靠 composer.json 中的 scripts 字段实现，通过严格匹配官方定义的事件名（如 post-install-cmd）触发对应脚本执行，本质是静态脚本执行模型而非运行时事件监听。

composer怎么编写事件监听插件_composer如何监听composer生命周期事件执行自定义逻辑【进阶】

Composer 的事件监听靠什么实现？

Composer 本身不提供“插件 SDK”或注册式事件 API，所有生命周期钩子都通过 composer.json 中的 scripts 字段触发。它不是监听器模型，而是脚本执行模型——每个事件名（如 post-install-cmd）对应一个可执行命令列表。

脚本本质是 shell 命令或 PHP 函数调用，由 Composer 自己解析并执行
所有事件名必须严格匹配官方定义，大小写敏感，拼错就静默失效
不支持运行时动态注册，也不支持条件跳过（除非脚本自己判断）

常见错误现象：post-update-cmd 没执行？检查是否写成 post-update 或 post-update-command；或者脚本返回非零退出码导致后续中断。

怎么写一个能被 `post-autoload-dump` 触发的 PHP 函数？

函数必须满足两个硬性条件：可被自动加载、签名符合 Composer 调用约定（接受 $event 参数）。

<?php // src/ScriptHandler.php
namespace MyVendor;
<p>use Composer\Script\Event;<p>class ScriptHandler
{
public static function onAutoloadDump(Event $event)
{
$vendorDir = $event->getComposer()->getConfig()->get('vendor-dir');
file_put_contents("$vendorDir/../generated-by-composer.txt", "dumped at " . date('c'));
}
}</p>

必须声明为 public static，Composer 只认静态方法
参数类型提示 Event 不是必须的，但强烈建议加，否则 IDE 和类型检查失效
方法名任意，但调用时要完整写成 MyVendor\ScriptHandler::onAutoloadDump
如果类不在 autoload 配置中（如 "psr-4": {"MyVendor\": "src/"}），函数永远不会被找到

哪些事件在 `composer install` 时实际会触发？

不是所有文档列出的事件都会跑，触发取决于操作上下文和本地状态：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

pre-install-cmd 和 post-install-cmd 总是触发（只要没加 --no-scripts）
pre-autoload-dump 和 post-autoload-dump 仅当 autoloader 确实被重建时才触发（例如 composer.lock 变更、PHP 版本变化、autoload 配置变动）
post-root-package-install 只在根项目（即你当前 composer.json 所在项目）安装时触发，不会在依赖包内部触发