COMPOSER_HOME是Composer的主目录，用于存储配置、认证和全局包，如config.json、auth.json及vendor下的全局工具；COMPOSER_CACHE_DIR则专用于存放缓存文件，如下载的压缩包和元数据，可独立设置以提升性能或隔离缓存。两者分离便于在CI/CD、Docker等场景优化资源管理与构建速度。
Composer 是 PHP 的依赖管理工具，它在运行时会使用多个目录来存储配置、缓存和全局安装的包。其中 COMPOSER_HOME 和 COMPOSER_CACHE_DIR 是两个关键的环境变量，它们控制着 Composer 的行为路径，但用途不同。理解它们的区别有助于更好地管理开发环境、CI/CD 流程或共享系统中的资源。
COMPOSER_HOME：Composer 的主工作目录
COMPOSER_HOME 指定 Composer 的根目录，用于存放用户级别的配置和全局安装的内容。这个目录相当于 Composer 的“家”，就像 ~/.composer 在类 Unix 系统上的默认位置。
该目录通常包含以下子目录和文件：
- config.json：用户级别的全局配置（如镜像设置、GitHub OAuth token）
- auth.json：认证信息（推荐放在此目录以避免泄露）
-
vendor/：通过
composer global require安装的全局包 - cache/：部分缓存内容（除非 COMPOSER_CACHE_DIR 单独指定）
例如，当你运行：
composer global require friendsofphp/php-cs-fixer这个命令会把 php-cs-fixer 安装到 $COMPOSER_HOME/vendor/bin，你可以将该路径加入 PATH 来全局调用。
COMPOSER_CACHE_DIR：专门的缓存存储目录
COMPOSER_CACHE_DIR 只负责指定缓存文件的存放位置，包括下载的包压缩包（zip/tar）、版本元信息、已解压的归档等。它的存在是为了将缓存从主配置目录中分离出来，便于清理、挂载或共享。
如果你不设置此变量，缓存默认位于 $COMPOSER_HOME/cache。但你可以将其指向其他位置，比如：
- 临时磁盘（提高 I/O 性能）
- Docker 中的临时卷（避免持久化缓存）
- 构建服务器上的共享缓存目录（加速 CI 构建）
设置方式：
export COMPOSER_CACHE_DIR="/tmp/composer-cache"
之后 Composer 所有下载和提取的缓存都会存放在该路径下，不影响配置和全局包。
两者关系与典型使用场景
COMPOSER_HOME 是“主目录”，而 COMPOSER_CACHE_DIR 是其一个可选的子功能重定向。你可以把前者看作“用户数据区”，后者是“临时数据区”。
常见组合用法：
-
开发机器上：保持默认，
~/.composer包含所有内容。 -
CI 环境中：设置
COMPOSER_CACHE_DIR=/cache并挂载 SSD 或内存盘，加快依赖安装速度；同时避免写入主 HOME 目录。 -
多用户系统：每个用户有自己的
COMPOSER_HOME，但共享只读缓存（需特殊配置）。 -
Docker 镜像构建：将
COMPOSER_CACHE_DIR指向临时层，避免缓存污染镜像大小。
如何验证当前设置？
你可以通过以下命令查看 Composer 实际使用的路径：
composer config --list --global输出中会显示：
-
home：对应 COMPOSER_HOME -
cache-dir：最终解析的缓存路径（可能来自 COMPOSER_CACHE_DIR） -
cache-files-dir、cache-repo-dir等细分路径
也可以直接检查环境变量是否生效：
echo $COMPOSER_HOMEecho $COMPOSER_CACHE_DIR
基本上就这些。搞清楚这两个变量的职责，能让你更灵活地控制 Composer 的行为，特别是在自动化和多环境部署中尤为重要。不复杂但容易忽略。
