Composer包管理器怎么配置环境变量-composer-PHP中文网

Composer只认COMPOSER_HOME、COMPOSER_CACHE_DIR、COMPOSER_REPO_PACKAGIST等少数系统级变量：COMPOSER_HOME必须为绝对路径，含~或中文则静默退至默认目录；PATH须包含$COMPOSER_HOME/vendor/bin才能调用laravel等全局命令；COMPOSER_REPO_PACKAGIST镜像URL末尾必须带斜杠，否则404；所有变量配置后均需新开终端验证，且COMPOSER_HOME变更后需手动迁移auth.json并重装全局包。

composer包管理器怎么配置环境变量

Composer 本身不依赖你配置应用级环境变量（比如 APP_ENV 或 DB_HOST），它只认少数几个系统级变量——设错一个，global 命令就静默失效、缓存全丢、镜像不走，连 laravel 命令都找不到。

COMPOSER_HOME 必须是绝对路径，否则 global install 的命令全进错目录

这个变量决定全局配置、auth、缓存和 vendor/bin 的根位置。只要含 ~、$HOME、%USERPROFILE% 或中文字符，Composer 就自动退回到默认路径（~/.composer 或 %APPDATA%\Composer），你装的 laravel、phpunit 全在另一个地方。

Linux/macOS 正确写法：export COMPOSER_HOME="/home/yourname/.my-composer"（不能用 ~/my-composer）
Windows 正确写法：setx COMPOSER_HOME "C:\Users\YourName\AppData\Roaming\Composer"（引号内不能有空格，也不能用 C:\用户\）
设完必须新开终端——source ~/.zshrc 不管用，子进程不继承父 shell 的环境变量
验证方式：composer config --list --global，看 “Global configuration file” 行是否匹配你设的路径

PATH 必须包含 $COMPOSER_HOME/vendor/bin，否则全局命令找不到

Composer 从不自动把全局 bin 目录加进 PATH。它只负责把 laravel、phpunit 这类文件放进 $COMPOSER_HOME/vendor/bin，剩下的全靠你自己配。

Linux/macOS：在 ~/.zshrc 末尾加 export PATH="$COMPOSER_HOME/vendor/bin:$PATH"（顺序很重要，放前面防系统同名命令覆盖）
Windows：把 %COMPOSER_HOME%\vendor\bin 加进「用户变量 → Path」（不是 %APPDATA%\Composer\vendor\bin，除非你根本没设 COMPOSER_HOME）
加完必须新开终端，再运行 echo $PATH（macOS/Linux）或 echo %PATH%（Windows）确认路径存在
最后用 which laravel（macOS/Linux）或 where think（Windows）确认指向的是 vendor/bin 下的文件

COMPOSER_REPO_PACKAGIST 镜像地址必须带尾部斜杠，否则 404

这是唯一真正生效的镜像环境变量，优先级高于 composer.json 和 config.json 里的 repositories 配置。但 URL 写错一个字符，就会拼出非法路径。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

正确写法：export COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/（注意结尾 /）
错误写法：https://mirrors.aliyun.com/composer（少斜杠 → 请求变成 .../composerpackages.json → 404）
验证是否生效：composer config -g repo.packagist，输出应为 {"url": "https://mirrors.aliyun.com/composer/"}
CI 场景（如 GitHub Actions）需在 env: 块中显式声明，不能只靠 shell export

COMPOSER_CACHE_DIR 设错会导致每次 update 都重下包

这个变量控制下载包、解压、installer 缓存的位置。它不只影响首次安装速度，更关键的是决定 composer update 能否跳过重复下载——设错就等于每次都从零开始。

可独立于 COMPOSER_HOME 设置，例如 SSD 分区加速：export COMPOSER_CACHE_DIR="/mnt/ssd/composer-cache"
如果设为不可写路径，会出现 Failed to create cache directory: Permission denied，此时 Composer 会退回到内存缓存（极慢）或跳过缓存
Docker 构建中常见错误：把 COMPOSER_CACHE_DIR 指向 /tmp/composer-cache，而该路径在容器重启后丢失，缓存失效

最容易被忽略的是：所有这些变量设完都必须新开终端验证，旧终端进程不会读新值；而且 COMPOSER_HOME 改了之后，旧的 auth.json、config.json 和全局包不会自动迁移，得手动拷过去再重装一次 composer global install。