开发一个 Composer 插件需要了解哪些核心事件（events）？

开发 Composer 插件的核心是监听官方定义的生命周期事件。关键事件包括：①pre-install-cmd/post-install-cmd；②pre-update-cmd/post-update-cmd；③pre-autoload-dump/post-autoload-dump；④post-root-package-install；⑤post-create-project-cmd。

开发 Composer 插件时，核心在于监听并响应 Composer 在生命周期中触发的事件。这些事件不是自定义钩子，而是 Composer 官方定义、稳定且文档化的执行节点。掌握它们，才能在正确时机介入安装、更新、脚本执行等流程。

关键生命周期事件（按典型执行顺序）

以下是最常用、最实用的几个事件，覆盖绝大多数插件需求：

• pre-install-cmd 和 post-install-cmd：在 composer install 执行前后触发。适合做环境检查、生成配置文件、清理缓存等。注意：仅当本地没有 vendor/ 时才走 install 流程。
• pre-update-cmd 和 post-update-cmd：在 composer update 前后触发。比 install 更常被调用，适合处理依赖变更后的逻辑，比如重新生成 autoload 映射、校验包兼容性。
• pre-autoload-dump 和 post-autoload-dump：在 Composer 重新生成自动加载文件（vendor/autoload.php）前/后触发。这是修改类加载行为、注入自定义加载器或验证 PSR-4 结构的黄金时机。
• post-root-package-install：项目根 composer.json 第一次安装完成时触发（即新项目首次 install）。适合初始化项目专属文件，如创建 .env.example 或运行引导脚本。
• post-create-project-cmd：仅在 composer create-project 成功后触发。和上一个类似，但语义更明确，专用于模板项目（skeleton）的后续设置。

事件监听的实现方式

Composer 插件通过实现 Composer\Plugin\PluginInterface 并在 activate() 方法中订阅事件。事件对象（Event）提供访问 Composer 实例、IO 接口（用于输出）、以及当前命令上下文的能力。

标签： php js json composer 配置文件 作用域