开发Composer插件需创建type为composer-plugin的包,实现PluginInterface接口,并通过extra.class指定入口类,在activate方法中注册事件或命令。示例中插件监听post-install-cmd事件,执行自定义逻辑,可通过path仓库本地测试,使用composer install -vvv调试验证插件加载与事件触发。

开发Composer插件可以让你扩展Composer的功能,比如在安装包时执行自定义逻辑、监听事件、修改自动加载机制等。如果你熟悉PHP并希望为Composer生态贡献能力,开发一个插件是一个很好的切入点。下面介绍开发Composer插件的基本步骤。
了解Composer插件的工作原理
Composer插件本质上是一个特殊的Composer包,它实现了Composer\Plugin\PluginInterface接口,并通过注册服务提供者来注入自定义行为。当Composer运行并检测到已安装的插件时,会自动激活它。
关键点:
- 插件必须声明
"type": "composer-plugin"在composer.json中 - 需要依赖
composer-plugin-api - 主类实现
PluginInterface,并在activate()方法中绑定事件或注册命令
创建基本的插件结构
从零开始创建一个插件项目:
- 新建目录,例如:
my-composer-plugin - 初始化
composer.json:
{
"name": "your-vendor/my-composer-plugin",
"type": "composer-plugin",
"require": {
"php": "^7.4 || ^8.0",
"composer-plugin-api": "^2.0",
"composer/composer": "^2.0"
},
"autoload": {
"psr-4": {
"MyPlugin\\": "src/"
}
},
"extra": {
"class": "MyPlugin\\MyPlugin"
}
}注意extra.class字段指定了插件入口类。
- 创建插件主类:
// src/MyPlugin.php
namespace MyPlugin;
use Composer\Composer;
use Composer\IO\IOInterface;
use Composer\Plugin\PluginInterface;
class MyPlugin implements PluginInterface
{
public function activate(Composer $composer, IOInterface $io)
{
$io->write('My plugin is activated! ');
// 在这里注册事件监听器或自定义命令
}
public function deactivate(Composer $composer, IOInterface $io)
{
// 插件被停用时执行
}
public function uninstall(Composer $composer, IOInterface $io)
{
// 插件被卸载时执行
}
}监听Composer事件
插件的强大之处在于能响应Composer生命周期中的事件,比如包安装前后、自动加载生成等。
示例:监听post-install-cmd事件
Psky企业网站是基于PHP+MYSQL开发的一款企业官网宣传网站,支持PC、wap浏览。 主要功能包括导航管理、轮播新闻、单位动态、通知通报、单位简介、后台管理等。运行环境下载安装PHPStudy(小皮)即可。系统采用PHP语言(版本:7.3.4nts)和MYSQL(版本:5.7.26)数据库进行开发,安装PHPStudy(小皮)集成环境进行测试通过。安装步骤:1、导入SQL文件到PHPmyad
use Composer\EventDispatcher\EventSubscriberInterface;
use Composer\Script\ScriptEvents;
class MyPlugin implements PluginInterface, EventSubscriberInterface
{
public function activate(Composer $composer, IOInterface $io)
{
// 不需要手动注册,只要实现 EventSubscriberInterface 即可
}
public static function getSubscribedEvents()
{
return [
ScriptEvents::POST_INSTALL_CMD => 'onPostInstall',
];
}
public function onPostInstall()
{
file_put_contents('plugin_ran.txt', 'Post install hook triggered by plugin');
}
}确保你的类同时实现EventSubscriberInterface并定义getSubscribedEvents静态方法。
测试你的插件
最简单的测试方式是使用path类型的仓库,在另一个项目中本地引用插件:
{
"repositories": [
{
"type": "path",
"url": "../my-composer-plugin"
}
],
"require": {
"your-vendor/my-composer-plugin": "*"
}
}运行composer install,如果看到输出“My plugin is activated!”,说明插件已被加载。
提示: 开发期间建议开启调试模式:composer install -vvv,可以看到插件加载详情。
基本上就这些。掌握以上步骤后,你可以进一步探索添加自定义命令、操作包下载过程、修改自动加载映射等高级功能。Composer官方文档和现有插件(如hirak/prestissimo)是很好的学习资源。









