自定义安装器通过实现PluginInterface并注册Installer类，使特定类型包（如my-plugin）安装到指定目录（如plugins/），核心是重写getInstallPath()和supports()方法，并在composer.json中声明为composer-plugin。
编写一个自定义的 Composer 安装器，主要是为了让某些特定类型的包在安装时被放置到指定目录，而不是默认的 vendor 目录。这在开发框架插件、主题、模块等场景中非常有用。实现的关键是创建一个遵循 Composer 插件机制的类，并注册为自定义安装器。
理解 Composer 自定义安装器的工作原理
Composer 支持通过插件扩展其功能。自定义安装器本质上是一个插件，它实现了 Composer\Plugin\PluginInterface，并在激活时向 Composer 注册一个新的安装器类。这个安装器类决定某种类型（type）的包应该安装到哪个路径。
核心步骤包括：
- 定义插件并绑定到 Composer 事件
- 实现一个继承
Composer\Installer\LibraryInstaller的安装器类 - 重写
getInstallPath()方法来指定目标路径 - 在
composer.json中声明插件和包类型
创建自定义安装器类
假设你想让所有类型为 my-plugin 的包都安装到项目根目录下的 plugins/ 文件夹中。
首先创建安装器类：
// src/MyCustomInstaller.phpnamespace MyVendor\CustomInstaller;
use Composer\Installers\LibraryInstaller;
use Composer\Package\PackageInterface;
class MyCustomInstaller extends LibraryInstaller
{
public function getInstallPath(PackageInterface $package): string
{
$type = $package->getType();
if ($type !== 'my-plugin') {
throw new \InvalidArgumentException("Unknown package type: $type");
}
return 'plugins/' . $this->sanitizeName($package->getName());
}
public function supports($packageType): bool
{
return $packageType === 'my-plugin';
}
}
说明：
-
supports()方法告诉 Composer 这个安装器能处理哪种类型的包 -
getInstallPath()返回实际安装路径，可使用$this->sanitizeName()处理包名中的斜杠等字符
实现插件接口以激活安装器
创建插件类来注册你的安装器：
// src/Plugin.phpnamespace MyVendor\CustomInstaller;
use Composer\Composer;
use Composer\IO\IOInterface;
use Composer\Plugin\PluginInterface;
class Plugin implements PluginInterface
{
public function activate(Composer $composer, IOInterface $io)
{
$installer = new MyCustomInstaller($io, $composer);
$composer->getInstallationManager()->addInstaller($installer);
}
}
这个 activate() 方法会在插件启用时调用，将你的安装器加入 Composer 的安装管理器中。
配置 composer.json
在你的插件项目的 composer.json 中声明必要的信息：
注意点：
-
type必须是composer-plugin -
extra.class指定插件入口类 - 依赖
composer-plugin-api是必须的
使用你的自定义安装器
当你发布这个插件后，其他项目可以通过引入它来支持 my-plugin 类型的包：
然后就可以安装类型为 my-plugin 的包，它们会自动被放到 plugins/ 目录下。
例如，某个插件的 composer.json 可以这样写：
基本上就这些。只要逻辑清晰，结构正确，Composer 自定义安装器并不难实现。关键是理解插件机制和安装器的生命周期。测试时建议使用 composer install --dry-run 来验证路径是否正确。
