Composer配置自定义路径的操作方法-composer-PHP中文网

config.vendor-dir 是唯一真正生效的项目级 vendor 路径配置，须在项目根目录 composer.json 的 config 字段下用相对路径设置（如 "third-party"），并删除旧 vendor 后执行 install 才生效。

composer配置自定义路径的操作方法

config.vendor-dir 是唯一真正生效的项目级 vendor 路径配置

想让当前项目所有包装进 third-party 或 libs，只能在项目根目录的 composer.json 里写死 "config": {"vendor-dir": "third-party"}。其他方式——比如 COMPOSER_VENDOR_DIR 环境变量、composer install -d 参数、全局 config.json —— 在 Composer 2.x 中全部失效或被忽略。

必须满足三个条件才起作用：

配置放在 composer.json 最外层 config 字段下，不能缩进错位，也不能塞进 extra
值必须是相对路径（如 "libs"），不能以 / 开头，不支持 ~ 或 $HOME
改完后必须删掉整个旧 vendor 目录，再跑 composer install；composer update 不会迁移已有包

改完后，third-party/autoload.php 才是真实入口，所有 require 'vendor/autoload.php' 都得手动改成新路径，IDE 和 CI 脚本同理。

COMPOSER_HOME 决定全局配置和缓存根目录

COMPOSER_HOME 是 Composer 启动时第一优先级读取的硬性路径，设了就用它，不设才 fallback 到默认位置（~/.composer 或 %APPDATA%\Roaming\Composer）。它不是可选配置项，而是唯一权威路径来源。

常见误操作：

只设环境变量但没手动迁移 auth.json 和 config.json → Composer 静默失败，报 Could not authenticate against repo.example.com
用 ~/my-composer 这类波浪号路径 → 某些 CI 工具或脚本里 shell 解析失败
临时 export 后没新开终端 → IDE、后台任务、CI 全部不生效

验证是否生效：运行 composer config --global home，输出必须和 echo $COMPOSER_HOME（Linux/macOS）或 echo %COMPOSER_HOME%（Windows）一致。

Discussion Composer

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

下载

cache-files-dir 必须显式指向 files 子目录

Composer 下载的 zip 包和解压后的 dist 文件，实际存在 cache-files-dir 下，而不是 cache-dir 根目录。只配 cache-dir 是无效的——它只是父容器，真正起作用的是 cache-files-dir，且必须明确指向其下的 files/ 子目录。

正确写法示例：

Linux/macOS：composer config --global cache-files-dir ~/.composer/cache/files
Windows：composer config --global cache-files-dir "%APPDATA%\Composer\Cache\files"（注意：PowerShell 中 %APPDATA% 不自动展开，建议先查清真实路径）

如果 composer config -g cache-files-dir 输出为空，说明该配置未设置，缓存将 fallback 到默认行为，下载包不会被复用。改完后务必执行 composer clear-cache 再跑一次 composer install，然后检查目标路径下是否生成了哈希命名的 .zip 文件（如 2a/2a3b4c5d.zip）。