Composer通过事件系统允许在执行过程中插入自定义逻辑，支持在composer.json中定义脚本或开发插件监听事件。1. 可在scripts字段注册事件如pre-install-cmd、post-update-cmd等，绑定命令或PHP回调函数；2. 自定义方法需接收Composer\Script\Event参数，用于获取环境与操作信息；3. 插件可通过EventSubscriberInterface订阅事件，利用EventDispatcher实现复杂逻辑；4. 事件回调可结合IO对象输出信息，提升脚本智能性。合理使用事件机制可扩展Composer行为，适配项目需求。
Composer 提供了事件系统（Event System），允许你在 Composer 执行过程中插入自定义逻辑。这是通过 Event Dispatcher 实现的，你可以在插件或项目中监听特定事件，比如在安装、更新、dump autoload 时执行某些操作。
理解 Composer 的事件机制
Composer 在运行过程中会触发一系列事件，例如：
- pre-install-cmd：在 install 命令执行前触发
- post-install-cmd：install 完成后触发
- pre-update-cmd：update 前触发
- post-update-cmd：update 后触发
- post-autoload-dump：自动加载生成后触发
- post-create-project-cmd：项目创建完成后触发
这些事件可以绑定到脚本或插件中的回调函数，实现自定义行为。
在 composer.json 中定义脚本钩子
最简单的方式是通过 composer.json 的 scripts 字段注册事件处理程序：
{
"scripts": {
"post-install-cmd": [
"echo '安装完成，开始执行清理任务...'",
"php scripts/clear-cache.php"
],
"post-update-cmd": "php scripts/regenerate-config.php",
"post-autoload-dump": [
"Composer\\Script\\Handler::optimizeAutoloader"
]
}
}
每个事件可绑定一个字符串命令或数组形式的多个命令。Composer 会按顺序执行它们。
编写自定义 PHP 回调函数
你可以写自己的静态方法来响应事件。方法需接受一个 Composer\Script\Event 参数：
getComposer();
echo "当前环境: " . $event->getOperation()->getName() . "\n";
// 执行你的逻辑
file_put_contents('updated.txt', date('Y-m-d H:i:s'));
}
public static function preInstall($event)
{
if (getenv('CI')) {
throw new RuntimeException("禁止在 CI 环境中执行 install");
}
}
}
然后在 composer.json 中引用：
"scripts": {
"pre-install-cmd": "MyScripts::preInstall",
"post-update-cmd": "MyScripts::postUpdate"
}
开发插件使用 EventDispatcher 注册监听器
如果你需要更复杂的控制，可以开发 Composer 插件。插件能使用完整的 EventDispatcher 接口动态监听事件：
getEventDispatcher();
$dispatcher->addSubscriber($this);
}
public static function getSubscribedEvents()
{
return [
InstallerEvents::PRE_INSTALL_CMD => 'onPreInstall',
InstallerEvents::POST_UPDATE_CMD => 'onPostUpdate',
];
}
public function onPreInstall(Event $event)
{
$event->getIO()->write("正在准备安装... ");
// 自定义检查逻辑
}
public function onPostUpdate(Event $event)
{
$event->getIO()->write("依赖已更新，刷新缓存...");
// 执行清理、生成等操作
}
}
同时，在 composer.json 中声明插件：
{
"name": "your-vendor/my-composer-plugin",
"type": "composer-plugin",
"require": {
"composer-plugin-api": "^2.0"
},
"autoload": {
"classmap": ["MyPlugin.php"]
},
"extra": {
"class": "MyPlugin"
}
}
安装该插件后，它将自动注册事件监听器。
基本上就这些。你可以根据项目需求选择使用简单的脚本钩子，或开发完整插件来扩展 Composer 行为。关键是理解事件生命周期和如何绑定回调。不复杂但容易忽略的是事件参数和 IO 对象的使用，合理利用它们能让脚本更智能。
