Composer安装器插件核心机制是实现InstallerInterface接口，通过严格匹配package的type字段（字符串相等），在getInstallPath()中返回相对于项目根目录的安装路径，从而接管特定type包的安装逻辑。
Composer 安装器插件的核心机制是什么
Composer 安装器插件本质是通过实现 ComposerInstallerInstallerInterface，接管某类包的安装逻辑。它不改变 composer.json 的声明方式，而是让 Composer 在遇到匹配的 type 时，跳过默认的 vendor/ 路径规则，执行你定义的复制、移动、生成等动作。
关键点在于：插件生效的前提是目标包的 type 字段与插件中声明的 supports 类型完全一致——不是前缀匹配，也不是模糊识别，是严格字符串相等。
- 插件必须在根项目（即运行
composer install的项目）中声明为require-dev或require，不能只放在被安装的包里 - 插件类需在
autoload中正确注册，否则 Composer 找不到入口 -
getInstallPath()返回的路径必须是相对于项目根目录的相对路径（如public/themes），不能以/开头，也不能用..跳出项目范围
如何让 type=theme 的包安装到 public/themes 而非 vendor/
这是最典型的自定义安装路径场景。你需要一个插件监听 theme 类型，并重写其安装路径和文件操作逻辑。
示例插件类中关键方法：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
public function getInstallPath(PackageInterface $package, $frameworkType = '')
{
return 'public/themes/'.$package->getPrettyName();
}
public function supports($packageType)
{
return $packageType === 'theme';
}
- 确保被安装的包（如
acme/my-theme）的composer.json中明确设置"type": "theme" - 插件自身需在根项目的
composer.json中声明"type": "composer-plugin"，并添加"extra": {"class": "My\ThemeInstaller"} - 如果包含
dist和source两种获取方式，插件默认只处理dist解压后的内容；若需处理source（如 Git clone），需重写install()方法手动拷贝
为什么 install 命令没报错但文件没出现在目标目录
常见现象是插件类已加载、supports() 返回 true，但目标目录空空如也。根本原因往往不在逻辑错误，而在 Composer 的缓存与生命周期阶段。
- Composer 会缓存已安装包的路径信息，修改插件后必须先运行
composer clear-cache，再删掉vendor/和composer.lock，重新composer install - 插件的
getInstallPath()只决定「安装到哪」，不负责「把什么放进去」；实际文件复制由 Composer 内部调用Installer::installCode()完成，该方法默认只复制source目录下的内容（即包根目录），不会自动包含tests/或resources/等子目录 - 若目标路径存在同名目录且非空，Composer 默认跳过覆盖——它不做递归清理，也不会提示冲突
多个 type 共存时怎么避免路径冲突或误匹配
当插件同时支持 theme、plugin、widget 时，不能靠 if-else 硬编码路径，必须把类型映射关系外置或结构化处理。
推荐做法是用配置驱动路径规则：
private $typePaths = [
'theme' => 'public/themes',
'plugin' => 'app/Plugins',
'widget' => 'resources/widgets',
];
- 每个
type对应的路径必须在getInstallPath()中拼接完整，例如$this->typePaths[$packageType].'/'.$package->getPrettyName() - 务必校验
$packageType是否存在于$this->typePaths中，否则未定义类型会触发 PHP Notice 或返回 false，导致 Composer 回退到默认 vendor 路径——这很难排查 - 路径值本身不能含通配符或变量，如
public/{type}s是无效的；Composer 不做字符串模板解析
真正难的是路径权限、符号链接兼容性，以及 Windows 下大小写敏感导致的 Public/Themes 和 public/themes 被视为不同目录——这些细节一旦出问题，连日志都不会报错，只会静默失败。
