Composer的COMPOSER_HOME环境变量有什么作用？如何修改？-composer-PHP中文网

Composer的COMPOSER_HOME环境变量有什么作用？如何修改？

穿越時空

发布： 2025-12-20 13:19:02

原创

125人浏览过

COMPOSER_HOME 环境变量指定 Composer 全局配置目录路径，影响 config.json、缓存、全局包及插件存储位置；默认路径因系统而异，可临时或永久修改，修改后需确保读写权限并可能需迁移旧全局包。

composer的composer_home环境变量有什么作用？如何修改？

COMPOSER_HOME 环境变量用于指定 Composer 的全局配置目录位置，它决定了 Composer 存放全局配置文件（config.json）、缓存（cache/）、全局安装的可执行包（vendor/bin/）以及插件数据的根路径。

如果不设置 COMPOSER_HOME，Composer 会按操作系统自动选择默认目录：

所有全局操作（如 composer global require、composer config --global）都基于该目录工作。修改它会影响全局配置生效位置和包安装位置，但不会影响项目级的 composer.json 和 vendor/ 目录。

在运行 Composer 命令前，直接设置环境变量即可：

小微助手

微信推出的一款专注于提升桌面效率的助手型AI工具

249

Linux/macOS：COMPOSER_HOME=/path/to/my-composer-home composer global require laravel/installer
Windows（CMD）：set COMPOSER_HOME=C:\my-composer && composer global require laravel/installer
Windows（PowerShell）：$env:COMPOSER_HOME="C:\my-composer"; composer global require laravel/installer

将环境变量写入 shell 配置文件或系统环境变量中，使每次打开终端都自动生效：

Linux/macOS：在 ~/.bashrc、~/.zshrc 或 ~/.profile 中添加一行：
export COMPOSER_HOME="$HOME/.my-composer"
然后执行 source ~/.zshrc（或对应文件）刷新。
Windows：通过「系统属性 → 高级 → 环境变量」添加用户或系统变量 COMPOSER_HOME，值设为例如 C:\Users\YourName\composer，重启终端生效。