如何使用Composer创建一个自定义的项目安装器（Custom Installer）？

自定义安装器生效需目标包声明”type”且插件正确注册；create-project不触发因仅处理源项目自身type；须分设插件包（type:composer-plugin）和目标包（type:your-custom-type），通过supports()匹配并install()执行逻辑。

Composer 自定义安装器不是靠“创建一个新包”就能生效的，而是必须让目标包在 composer.json 中声明 "type": "xxx"，再通过插件注册对应安装逻辑——否则 Composer 根本不会调用你的安装器。

为什么 composer create-project 不触发自定义安装器？

因为 create-project 是克隆并安装源项目本身，它只运行该项目的 composer.json 中定义的 type 对应的安装器（如果有的话），而不是你本地开发的插件。真正触发自定义安装器的场景是：其他项目在 require 了你发布的、"type": "my-plugin-type" 的包之后执行 composer install 或 composer update。

• 自定义安装器本质是 ComposerPluginInstallerPluginInterface 实现，必须打包为独立插件包（type: composer-plugin）并发布到 Packagist
• 被安装的目标包（即你要特殊处理的那个包）必须设置 "type": "your-custom-type"
• 插件包和目标包是两个分离的包，不能写在同一个 composer.json 里

如何编写最小可用的自定义安装器类？

核心是继承 ComposerInstallerLibraryInstaller 并重写 supports() 和 install()（或 update()）。不要直接实现 InstallerInterface——它太底层，容易漏掉依赖解析、事件通知等关键流程。

• supports() 必须返回 true 仅当 $package->getType() === 'your-custom-type'，否则会被跳过
• install() 中可通过 $package->getExtra() 读取包作者定义的配置项（如部署路径、模板变量）
• 文件操作请始终使用 $this->vendorDir 和 $this->binDir 等 Composer 提供的路径，而非硬编码 vendor/
• 若需复制非源码文件（如配置模板、前端构建产物），建议在 post-install-cmd 中处理，避免干扰标准安装流程

插件包的 composer.json 关键字段怎么写？

插件包自身必须声明为 composer-plugin 类型，并通过 extra.composer-plugin 指明主类路径。Composer 会自动加载该类并调用其 activate() 方法。

{     "name": "acme/my-custom-installer",     "type": "composer-plugin",     "autoload": {         "psr-4": {             "Acme\Installer\": "src/"         }     },     "require": {         "composer-plugin-api": "^2.0",         "composer/composer": "^2.0"     },     "extra": {         "class": "Acme\Installer\MyCustomInstallerPlugin"     } }

• composer-plugin-api 版本必须与目标用户使用的 Composer 主版本对齐（v1 对应 Composer 1.x，v2 对应 2.x）
• require 中引入 composer/composer 是为了静态分析和 ide 支持，实际运行时不加载它的全部代码
• 插件类必须实现 ComposerPluginPluginInterface，并在 activate() 中调用 $installer = new MyCustomInstaller(...) 并注册进 $composer->getInstallationManager()->addInstaller($installer)

目标包如何声明自己需要被你的安装器处理？

只需在它的 composer.json 里写死 "type": "my-custom-type"。Composer 安装时会遍历所有已激活插件的 supports() 方法，匹配成功后才调用对应安装逻辑。

{     "name": "acme/my-special-package",     "type": "my-custom-type",     "extra": {         "deploy-to": "public/modules"     } }

• 这个 type 值必须和插件中 supports() 判断的字符串完全一致（区分大小写）
• extra 字段是唯一推荐的跨包传参方式；不要试图用 scripts 或环境变量传递路径等敏感信息
• 一旦 type 匹配失败，Composer 会回退到默认的 LibraryInstaller，把包放进 vendor/acme/my-special-package/，但不会报错——这是最常被忽略的调试盲点

最容易卡住的地方是插件未被正确激活，或 supports() 返回了错误的布尔值。建议在插件类的 activate() 和安装器的 supports() 中加 error_log() 输出调试信息，并用 composer show --plugins 确认插件已加载。