答案是创建一个自定义 Composer 命令插件需遵循 Composer 插件机制，首先建立包含 Plugin.php、src/MyCommand.php 和 composer.json 的项目结构，其中 composer.json 必须设置 type 为 composer-plugin 并指定 extra.class 入口类，然后在 Plugin 类中实现 getCapabilities() 返回 CommandProvider 类，该类提供继承自 SymfonyComponentConsoleCommandCommand 的命令实例，最后通过本地仓库测试或发布到 Packagist 供全局使用。
编写一个自定义的 Composer 命令插件，可以让开发者在使用 Composer 时执行特定的自定义逻辑，比如自动化项目初始化、环境检查或部署前处理。这个过程并不复杂，只需要遵循 Composer 插件机制和 Symfony Console 组件的命令结构。
创建插件项目结构
首先创建一个独立的 PHP 包作为插件项目。推荐目录结构如下：
my-composer-plugin/├── src/
│ └── MyCommand.php
├── composer.json
└── Plugin.php
这个包将包含一个主插件类（Plugin）和至少一个自定义命令（MyCommand）。
配置 composer.json
插件的核心是 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": { "MyComposerPlugin\": "src/" } }, "extra": { "class": "MyComposerPlugin\Plugin" } }注意：
- type 必须是 composer-plugin
- extra.class 指定插件入口类
- 引入 composer/composer 和 composer-plugin-api 是必需的依赖
实现插件入口类
在 Plugin.php 中实现 PluginInterface，并在激活时注册你的命令：
namespace MyComposerPlugin;
<p>use ComposerPluginPluginInterface;
use ComposerIOIOInterface;
use ComposerComposer;
use ComposerEventDispatcherEventSubscriberInterface;
use ComposerPluginCapabilityCommandProvider as CommandProviderCapability;</p><p>class Plugin implements PluginInterface, EventSubscriberInterface
{
public function activate(Composer $composer, IOInterface $io)
{
// 注册命令提供者
}</p><pre class="brush:php;toolbar:false;">public function getCapabilities()
{
return [
'ComposerPluginCapabilityCommandProvider' => 'MyComposerPluginCommandProvider'
];
}}
通过 getCapabilities() 返回命令提供者类，Composer 会在运行时加载它。
编写自定义命令
在 src/MyCommand.php 中创建一个继承 Command 的类：
namespace MyComposerPlugin;
<p>use SymfonyComponentConsoleCommandCommand;
use SymfonyComponentConsoleInputInputInterface;
use SymfonyComponentConsoleOutputOutputInterface;</p><p>class MyCommand extends Command
{
protected function configure()
{
$this->setName('my-command')
->setDescription('这是一个自定义 Composer 命令');
}</p><pre class="brush:php;toolbar:false;">protected function execute(InputInterface $input, OutputInterface $output)
{
$output->writeln('<info>自定义命令执行成功！</info>');
return Command::SUCCESS;
}}
添加命令提供者
创建 src/CommandProvider.php 来告诉 Composer 有哪些命令可用：
Shell本身是一个用C语言编写的程序，它是用户使用Linux的桥梁。Shell既是一种命令语言，又是一种程序设计语言。作为命令语言，它交互式地解释和执行用户输入的命令；作为程序设计语言，它定义了各种变量和参数，并提供了许多在高级语言中才具有的控制结构，包括循环和分支。它虽然不是Linux系统核心的一部分，但它调用了系统核心的大部分功能来执行程序、建立文件并以并行的方式协调各个程序的运行。因此，对于用户来说，shell是最重要的实用程序，深入了解和熟练掌握shell的特性极其使用方法，是用好Linux系统
namespace MyComposerPlugin;
<p>use ComposerPluginCapabilityCommandProvider as CommandProviderCapability;</p><p>class CommandProvider implements CommandProviderCapability
{
public function getCommands()
{
return [new MyCommand()];
}
}
</p>这个类的 getCommands() 方法返回所有你想注册的命令实例。
测试你的插件
在另一个项目的 composer.json 中添加你的插件进行本地测试：
{ "repositories": [ { "type": "path", "url": "../my-composer-plugin" } ], "require-dev": { "your-vendor/my-composer-plugin": "*" } }执行 composer install 安装后，就可以直接运行：
如果一切正常，你会看到输出：“自定义命令执行成功！”
发布与使用
将插件推送到 Packagist 后，其他用户只需：
composer require --dev your-vendor/my-composer-plugin之后就能使用你定义的命令了。
基本上就这些。核心在于理解 Composer 插件机制如何通过 CommandProvider 动态注册 Symfony Console 命令。只要结构清晰，自定义命令可以做很多事，比如生成文件、检查依赖、调用外部工具等。关键是不要忘记设置正确的 type 和 extra.class。
