Composer config --list 可查看全部配置;vendor-dir 和 bin-dir 是影响项目结构的关键项,分别控制依赖包和可执行脚本路径,修改后需删除对应目录并重新 install 才生效。

Composer 的 config 命令本身不直接列出所有配置项,但你可以用 composer config --list 查看当前项目或全局生效的全部配置;常用且影响项目结构的关键项确实是 vendor-dir 和 bin-dir,它们决定依赖包和可执行脚本的存放位置。
vendor-dir 配置:改了会影响 autoload 和 require 路径
这个值控制 vendor/ 目录的位置,默认是 vendor。一旦修改,autoload.php 生成路径、require 语句、以及 IDE 的自动补全都可能失效,除非你同步调整 autoload 配置或入口文件中的引入逻辑。
- 设置为相对路径(推荐):
composer config vendor-dir "lib/vendor" - 设置为绝对路径(慎用):
composer config vendor-dir "/var/www/myproject/vendor"—— 会导致composer install在不同机器上行为不一致 - 如果项目已存在
vendor/,改完后需手动删除并重新运行composer install,否则旧目录残留,新配置不生效
bin-dir 配置:影响 bin scripts 的安装路径和 $PATH 查找
bin-dir 指定 Composer 安装包中 bin 字段定义的可执行脚本(如 phpunit、laravel、doctrine)的软链接位置,默认是 vendor/bin。它必须是 vendor-dir 下的子目录,或与之同级——否则 composer install 会报错 "The bin-dir cannot be set to a directory outside the vendor-dir."
- 常见安全做法是设为
bin:composer config bin-dir "bin",然后把./bin加入$PATH或在 CI 中显式调用./bin/phpunit - 不能设为
/usr/local/bin这类系统路径——Composer 不会、也不该替你写系统级 bin - 改完后记得检查
composer show --platform是否仍能识别已安装的 bin 脚本;若缺失,删掉bin/并重装
其他高频相关配置项(配合 vendor-dir/bin-dir 使用)
单独改 vendor-dir 或 bin-dir 往往不够,下面这些常一起调整:
-
data-dir:缓存和插件数据默认存~/.composer,CI 环境建议设为composer config --global data-dir "$HOME/.composer-cache"避免权限问题 -
cache-dir:可单独指定缓存路径,比如composer config cache-dir "$HOME/.composer/cache",和data-dir分开更利于清理 -
process-timeout:某些大包(如symfony/symfony)解压慢,超时默认 300 秒,可加长:composer config process-timeout 1200 -
fxp-asset-proxy(已弃用):老项目可能还留着,现在应统一用packagist.org镜像或repositories配置
composer config --list | grep -E "(vendor-dir|bin-dir|data-dir|cache-dir)"
真正容易被忽略的是:这些配置项在 composer.json 里修改后,不会自动同步到已存在的 vendor/ 或 bin/ 目录——必须删掉对应目录再重装,否则表面配置生效,实际行为还是旧路径。










