composer怎么自定义安装路径_composer自定义安装器使用方法

composer install 默认安装到 vendor 目录；修改 vendor-dir 仅在 vendor 不存在时生效，需删除 vendor 和 composer.lock 后重新 install 才生效，且需同步更新所有引用路径。

composer install 默认装到哪？改 vendor-dir 真的能“重命名” vendor 目录吗

不能靠改名或软链接“骗过” Composer，vendor-dir 配置只在 vendor 目录不存在时生效，不是运行时重定向开关。它本质是告诉 Composer：“下次从零安装时，把包写到这个路径”，而不是“把已有的 vendor 移过去”。

• 已存在 vendor 目录时，改了 composer.json 里的 "config": {"vendor-dir": "libs"} 完全没用
• 必须先 rm -rf vendor composer.lock，再跑 composer install，新路径才起作用
• vendor/autoload.php 路径会变——你代码里写的 require 'vendor/autoload.php' 得同步改成 require 'libs/autoload.php'
• vendor/bin/xxx 也会变成 libs/bin/xxx，CI 脚本、Dockerfile、ide 的 PATH 或外部调用都得跟着改

想让某个包（比如 wordpress 插件）不进 vendor，该用什么机制

Composer 本身不支持按包名指定路径，但支持按 type 分发——这是唯一官方认可、稳定可用的方式。核心是：插件声明自己的 type，你用 composer/installers 或自定义 Installer 拦截该类型。

• 第三方包必须自己设 "type": "wordpress-plugin"，你无法替它改；否则 composer/installers 根本不识别
• 项目根目录 composer.json 加 "extra": {"installer-paths": {"wp-content/plugins/{$name}": ["type:wordpress-plugin"]}} 即可生效
• 通配只认 type: 和 vendor/name，不支持正则或模糊匹配，["acme/*"] 可以，["*my-tool*"] 不行
• 别用 post-install-cmd 脚本移动文件——这会破坏 composer.lock 记录的路径、导致 composer update 误判为未安装而反复重装

写一个自定义 Installer 插件，为什么 activate() 里必须调 addInstaller()

因为 Composer v2 的插件生命周期里，activate() 是唯一能注册 Installer 实例的地方；漏掉 $installerManager->addInstaller()，你的类根本不会被调用，连 supports() 都不会执行——看起来“插件装上了”，实际完全静默。

• 你的 Installer 类必须继承 LibraryInstaller，并实现 supports()、getInstallPath()、isInstalled()
• getInstallPath() 返回值不能以 / 开头（否则抛 InvalidArgumentException），且必须是相对项目根目录的路径，例如 'packages/' . $package->getName()
• isInstalled() 必须准确返回 true 当目录存在且含 composer.json，否则 composer update 每次都认为包没装，强制重拉重解压
• extra.class 必须指向完整命名空间类名，且该类需在 autoload 中正确映射，否则插件加载失败无提示

bin-dir 改了，为什么 phpunit 还是找不到

因为 bin-dir 只控制二进制文件生成位置，不影响系统 PATH 或当前 shell 的命令查找路径。改完不加进环境变量，终端当然不认识新路径下的命令。

• 项目级配置："config": {"bin-dir": "scripts/tools"} → 文件生成到 scripts/tools/phpunit
• 全局配置：composer config --global bin-dir "/usr/local/bin" → 所有没设本地 bin-dir 的项目都走这里
• linux/macos：在 ~/.zshrc 或 ~/.bash_profile 加 export PATH="scripts/tools:$PATH"，然后 source 一下
• windows：需手动把新路径加进系统环境变量 PATH，CMD/PowerShell 才能直接敲 phpunit
• 注意：改 bin-dir 不会自动迁移旧文件，必须重新 composer install 或 composer update

真正难的从来不是改配置项，而是所有依赖路径的上下文是否同步更新——autoload 引入、脚本调用、IDE 索引、CI 流水线、甚至队友本地开发环境，只要漏掉一处，就卡在 Class not found 或 command not found 上。