Composer插件通过实现PluginInterface扩展功能，可在激活时注册事件监听或添加自定义安装器。1. 创建类型为composer-plugin的包，依赖composer-plugin-api；2. 实现activate()方法并监听事件如post-install-cmd；3. 通过extra.class指定主类；4. 可注册自定义安装器支持新包类型；5. 插件自动被发现启用，也可用--no-plugins禁用。
Composer 插件是一种扩展 Composer 本身功能的方式，通过实现 composer-plugin-api，你可以监听事件、修改依赖解析过程、添加自定义安装器，甚至改变包的加载行为。要开发一个自定义插件，你需要遵循特定结构并实现核心接口。
创建基本插件结构
一个 Composer 插件本质上是一个普通的 Composer 包，只是它实现了 Composer\Plugin\PluginInterface 接口，并在 composer.json 中声明为插件类型。
步骤如下：
- 新建目录如
my-composer-plugin - 运行
composer init初始化项目 - 设置类型为
composer-plugin - 添加对
composer-plugin-api的依赖
{
"name": "your-vendor/my-composer-plugin",
"type": "composer-plugin",
"require": {
"composer-plugin-api": "^2.0"
},
"autoload": {
"psr-4": {
"YourVendor\\Plugin\\": "src/"
}
},
"extra": {
"class": "YourVendor\\Plugin\\MyPlugin"
}
}
实现 PluginInterface
插件主类必须实现 Composer\Plugin\PluginInterface 的 activate() 方法。该方法接收 Composer\Composer 和 Composer\IO\IOInterface 实例，可用于注册事件监听器或修改内部组件。
composer = $composer;
$this->io = $io;
// 可在此处替换安装器、注入资源等
$this->io->write('MyPlugin 已激活 ');
}
public static function getSubscribedEvents()
{
return [
ScriptEvents::POST_INSTALL_CMD => 'onPostInstall',
ScriptEvents::POST_UPDATE_CMD => 'onPostUpdate',
];
}
public function onPostInstall(Event $event)
{
$this->io->write('执行安装后自定义逻辑... ');
// 比如生成文件、清理缓存等
}
public function onPostUpdate(Event $event)
{
$this->io->write('执行更新后自定义逻辑... ');
}
}
注册与测试插件
要使用你的插件，需在目标项目的 composer.json 中引入它，并确保启用插件机制。
- 将插件发布到私有或公共仓库（如 Packagist），或使用路径仓库本地测试
- 在测试项目中添加依赖：
composer require your-vendor/my-composer-plugin - Composer 会自动发现并激活插件（因
extra.class被识别）
你也可以临时禁用插件验证来调试：
composer install --no-plugins
高级用途：自定义安装器或包类型
除了事件监听，插件还能注册新的包类型安装器。例如支持 type: my-custom-type 的包：
use Composer\Installer\InstallerInterface;
use Composer\Package\PackageInterface;
class MyCustomInstaller implements InstallerInterface
{
public function supports($packageType)
{
return $packageType === 'my-custom-type';
}
public function isInstalled(Composer $composer, PackageInterface $package)
{
// 判断是否已安装
}
public function install(Composer $composer, PackageInterface $package)
{
// 自定义安装逻辑
}
// 实现 update, uninstall 等方法...
}
在 activate() 中注册：
$installer = new MyCustomInstaller($this->io, $this->composer); $manager = $this->composer->getInstallationManager(); $manager->addInstaller($installer);
基本上就这些。Composer 插件机制强大但需谨慎使用，避免破坏标准流程。只要遵循接口规范，就能安全地扩展 Composer 行为。
