编写 Composer 插件无需修改源码，只需实现 PluginInterface 和 EventSubscriberInterface 接口，通过 activate() 注入逻辑、getSubscribedEvents() 绑定事件，并可选实现 CommandProviderInterface 添加自定义命令；插件需设 type 为 composer-plugin，正确配置 autoload 和入口类。
编写 Composer 插件并不需要修改 Composer 源码，而是通过实现特定接口、注册事件监听器，在 Composer 的生命周期中注入自定义逻辑。核心在于理解 Composer 的插件机制和事件驱动模型。
了解 Composer 插件类型与入口点
Composer 支持两类插件：全局插件（安装在 COMPOSER_HOME）和项目级插件（作为依赖写在项目 composer.json 中）。无论哪种，都必须满足：
- 包的
type字段为composer-plugin - 在
composer.json中声明extra.plugin-class或通过自动发现机制指定主类 - 主类必须实现
Composer\Plugin\PluginInterface
创建基础插件类
新建一个类（例如 MyPlugin），实现两个必需方法：activate() 和 deactivate()。常用做法是在 activate() 中绑定命令或监听事件：
use Composer\Plugin\PluginInterface; use Composer\IO\IOInterface; use Composer\Composer; use Composer\EventDispatcher\EventSubscriberInterface;class MyPlugin implements PluginInterface, EventSubscriberInterface { public function activate(Composer $composer, IOInterface $io) { // 可选：注册自定义命令（需同时实现 CommandProviderInterface） // 可选：监听事件，如下 }
public function deactivate(Composer $composer, IOInterface $io) {} public static function getSubscribedEvents() { return [ 'post-install-cmd' => 'onPostInstall', 'post-update-cmd' => 'onPostUpdate', ]; } public function onPostInstall($event) { /* 自定义逻辑 */ } public function onPostUpdate($event) { /* 自定义逻辑 */ }}
扩展命令或添加新命令
若想添加新 CLI 命令（如
composer hello），插件类还需实现Composer\Command\CommandProviderInterface，并返回命令实例数组：
- 继承
Composer\Command\BaseCommand编写命令类 - 重写
configure()设置名称、描述、参数 - 重写
execute()实现业务逻辑（可访问$this->getComposer()和$this->getIO()） - 在插件的
getCommands()方法中返回该命令实例
发布与测试插件
本地开发时，用 path 仓库方式在测试项目中引入插件，避免反复发布：
// 测试项目的 composer.json
"repositories": [
{
"type": "path",
"url": "../my-composer-plugin"
}
],
"require-dev": {
"myvendor/my-composer-plugin": "*"
}运行 composer update 后，插件即生效。检查是否加载成功，可运行 composer list 查看新增命令，或加 -v 参数观察插件激活日志。
基本上就这些。不复杂但容易忽略的是命名空间自动加载配置和插件类的 PSR-4 映射——确保 composer.json 中的 autoload 正确指向你的插件类文件。
