composer可通过config.vendor-dir、环境变量composer_vendor_dir或composer config命令修改依赖安装路径;需手动删除旧vendor并重装,同步更新autoload.php引用及ide/框架硬编码路径。

composer.json 里用 config.vendor-dir 指定目录
Composer 默认把依赖装进项目根目录下的 vendor 文件夹,改它最直接。在项目根目录的 composer.json 里加一段配置就行:
{
"config": {
"vendor-dir": "lib/vendor"
}
}
之后运行 composer install 或 composer update,依赖就会装到 lib/vendor 下。注意:vendor-dir 是相对路径,从项目根目录算起;如果写成绝对路径(比如 /var/www/myapp/vendor),Composer 会报错。
- 修改后首次运行命令时,旧
vendor不会自动删,得手动删掉再装,否则 autoload 可能混用旧文件 - PHP 的
autoload.php路径会跟着变,所有 require / include 都得同步更新,比如从vendor/autoload.php改成lib/vendor/autoload.php - 某些 IDE 或工具硬编码了
vendor名字(比如 PHPStan、Psalm),可能需要额外配置才能识别新路径
全局配置 COMPOSER_VENDOR_DIR 环境变量
不想改每个项目的 composer.json?可以用环境变量统一控制。在 shell 里执行:
export COMPOSER_VENDOR_DIR="/path/to/my/vendor"
或者写进 ~/.bashrc 或 ~/.zshrc 永久生效。这个变量优先级高于 composer.json 里的 config.vendor-dir,也高于 composer config --global 的设置。
- Windows 用户用
set COMPOSER_VENDOR_DIR=...(cmd)或$env:COMPOSER_VENDOR_DIR="..."(PowerShell) - CI/CD 流水线里推荐用环境变量方式,避免污染项目配置
- 该变量只影响当前 shell 会话及子进程,别忘了在 Dockerfile 或部署脚本里显式设置
composer config vendor-dir 命令行临时改写
想快速试一个路径,又不想编辑 JSON?用命令行直接写入本地配置:
composer config vendor-dir lib/ext
这会在项目 composer.json 的 config 节里追加或覆盖 vendor-dir 字段,效果和手动编辑一样,但更防手误。加 --global 参数可写入全局配置(影响所有项目):
composer config --global vendor-dir ~/.composer/vendor
不过全局设了容易和项目级冲突,尤其团队协作时——别人拉代码没配环境变量,又没改本地 composer.json,就还是走默认 vendor。
- 执行命令后不会自动重装依赖,得自己跑
composer install -
composer config写入的是 JSON,如果composer.json本身格式不规范(比如末尾多逗号),命令会失败 - Git 提交
composer.json时,vendor-dir变更会被记录,要确认这是团队共识
改完路径后 autoload 和 autoloader 失效的常见原因
改了 vendor-dir 却报 Class not found,大概率不是路径没生效,而是 autoloader 没重建或引用错了:
-
vendor/autoload.php是生成出来的文件,路径一变就得重新生成,删掉整个vendor目录再composer install - PSR-4 映射写在
composer.json的autoload段里,和vendor-dir无关,别误以为要一起改 - 某些框架(如 Laravel)在
bootstrap/autoload.php或public/index.php里硬写了require __DIR__.'/../vendor/autoload.php',这种必须手动改路径 -
composer dump-autoload -o不会改变 autoload.php 位置,它只优化已存在的 autoloader
路径灵活是好事,但 Composer 的加载机制认的是实际文件位置,不是配置名。改完别急着跑业务代码,先验证 vendor/autoload.php 是否真存在、能否被 require 进来。










