最可靠方式是通过 composer.json 的 config.vendor-dir 设置 vendor 目录路径,它优先级最高、全命令生效且官方完全支持;需删除旧 vendor 后重新 install,并同步更新 autoload、IDE 路径及硬编码引用。
composer.json 里用 config.vendor-dir 指定路径最可靠
Composer 官方支持通过 config.vendor-dir 控制 vendor 目录位置,这是唯一被完全兼容的方式。它优先级高于命令行参数和环境变量,且对所有命令(install、update、require)生效。
在项目根目录的 composer.json 中添加:
{
"config": {
"vendor-dir": "lib/vendor"
}
}
- 路径是相对于
composer.json所在位置的,不支持绝对路径(如/var/www/vendor) - 修改后需删掉旧
vendor目录再运行composer install,否则残留文件可能引发自动加载错误 - 如果项目含多个子模块共用同一 Composer 配置,该设置会统一影响全部,注意路径冲突
用 -d 参数临时切换配置目录不等于改 vendor 路径
composer -d /path/to/project install 只是告诉 Composer 去哪找 composer.json 和 composer.lock,它不会改变 vendor-dir 的解析逻辑。很多人误以为加了 -d 就能“换地方装”,其实 vendor 还是按原配置写进默认位置。
- 这个参数本质是切换工作上下文,不是路径重定向
- 若想配合自定义 vendor,仍需在目标项目的
composer.json里显式设config.vendor-dir - CI/CD 脚本中滥用
-d而忽略配置一致性,容易导致本地能跑、流水线报Class not found
全局配置 COMPOSER_VENDOR_DIR 环境变量只在特定场景生效
设置 COMPOSER_VENDOR_DIR=lib/vendor 后,只有当 composer.json 里没声明 config.vendor-dir 时,该变量才起作用。一旦项目配置存在,环境变量会被直接忽略。