Composer自定义路径如何指定安装位置-composer-PHP中文网

唯一真正生效的方式是在项目根目录composer.json的config字段中配置"vendor-dir"，如"third-party"；必须删除旧vendor后执行install，且require路径、bin-dir、ide及ci脚本均需同步更新。

composer自定义路径如何指定安装位置

config.vendor-dir 是唯一真正生效的路径配置方式

想让所有包装进 third-party 或 libs 而不是默认 vendor，只能靠项目根目录 composer.json 里的 "config": {"vendor-dir": "third-party"}。其他方法——比如 COMPOSER_VENDOR_DIR 环境变量、-d 参数、全局 config.json ——在 Composer 2.x 中已被移除或静默忽略。

这个配置必须满足三个硬性条件才起作用：

写在项目根目录 composer.json 的最外层 config 字段下，不能错放到 extra 或缩进错误
值必须是相对路径（如 "libs"），不能以 / 开头，也不支持 $HOME 或通配符
运行 composer install 前，旧 vendor 目录必须已删除；composer update 不会迁移已有包

-d 参数根本不会改 vendor 写入位置

composer install -d /tmp/myapp 看起来像把包装到 /tmp/myapp/vendor，其实它等价于 cd /tmp/myapp && composer install——vendor 还是照常写进 /tmp/myapp/vendor（或该目录下已配置的 vendor-dir）。很多人在 CI 脚本里滥用这个参数，结果本地跑通、流水线报 Class not found，根本原因是只换了工作目录，没同步配对 vendor-dir。

如果你真需要在临时目录安装依赖，正确做法是：

先确保目标目录（如 /tmp/myapp）下已有带 config.vendor-dir 的 composer.json
删掉该目录下的旧 vendor
再执行 composer install（不用加 -d）

installer-paths 只对特定 type 的包生效

extra.installer-paths 不是“按包名路由”，而是“按 installer 类型分发”。它只在以下三个条件同时满足时触发：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

项目已通过 composer require composer/installers 引入对应 installer（且版本 ≥ 2.0）
目标包自身 composer.json 明确声明了匹配的 type（如 "type": "wordpress-plugin"），普通 library 类型完全不触发
必须删掉整个 vendor 和 composer.lock，再跑 composer install——它不会重排已有包

示例配置（写在根项目 composer.json 的 extra 字段下）：

"extra": {
  "installer-paths": {
    "wp-content/plugins/{$name}/": ["type:wordpress-plugin"],
    "web/core/": ["drupal/core"]
  }
}

注意：{$name} 是占位符，会被替换成包名最后一段（如 acme/my-plugin → my-plugin）；路径必须相对于项目根目录，不能以 / 开头。

改完 vendor-dir 后 autoload 和 bin 都要手动同步

vendor/autoload.php 是生成时写死路径的入口文件。你改了 vendor-dir，但没重建整个 vendor 结构，旧文件还在原地，PHP 还在找原来的 vendor/autoload.php。

所以必须：

删掉现有 vendor 目录
执行 composer install 或 composer update（dump-autoload 不够，它只刷新类映射，不重建入口文件）
代码里所有 require 'vendor/autoload.php' 都得改成新路径，比如 require 'third-party/autoload.php'
如果用了 bin 文件（如 phpunit），必须在 config 中同时指定 bin-dir，且值要匹配新 vendor 下的子目录，例如：
```
"config": {
  "vendor-dir": "third-party",
  "bin-dir": "third-party/bin"
}
```
IDE（如 PHPStorm）需手动在 Settings → PHP → Include Paths 中添加新路径；CI 脚本中所有硬编码的 vendor/bin/phpunit 也得更新