COMPOSER_MIRROR_PATH_REPOS用于CI/CD中加速PHP项目依赖安装，当本地已存在私有或开发包时，通过设置该环境变量并配置path类型仓库，使Composer直接从本地路径软链接包，跳过下载。使用时需在composer.json中定义path仓库并设置COMPOSER_MIRROR_PATH_REPOS=1，适用于GitHub Actions等CI场景，显著减少构建时间，保持部署一致性。
COMPOSER_MIRROR_PATH_REPOS 是 Composer 提供的一个环境变量，用于在 CI/CD 构建环境中加速依赖安装过程。它的核心作用是启用本地路径镜像（Path Repository Mirroring），将项目中某些依赖包映射到本地文件系统路径，避免重复下载或构建，特别适用于私有包或本地开发包的场景。
什么情况下使用 COMPOSER_MIRROR_PATH_REPOS
当你在 CI 环境中需要频繁构建包含本地或私有组件的 PHP 项目时，常规做法是通过 Git 或私有 Packagist 仓库拉取依赖，这会增加网络请求和等待时间。如果这些包已经存在于本地（比如通过 git clone 或缓存获取），就可以利用 COMPOSER_MIRROR_PATH_REPOS 让 Composer 直接从本地路径“软安装”这些包，跳过下载步骤。
注意：该功能主要配合 path 类型的 repository 使用，并要求包版本匹配。
如何配置本地 Path 镜像仓库
启用该功能需要两个条件：
示例 composer.json 配置：
{
"repositories": [
{
"type": "path",
"url": "../my-private-package"
}
],
"require": {
"acme/my-private-package": "*"
}
}
当执行 composer install 时，如果设置了 COMPOSER_MIRROR_PATH_REPOS=1，Composer 会：
- 检查目标路径 ../my-private-package 是否存在且包含 composer.json
- 将该包软链接（或复制）到 vendor 目录
- 自动生成 dist 信息，使其像从远程仓库下载的一样
- 加快安装速度，尤其在 CI 中可显著减少构建时间
CI 中的实际应用建议
在 GitHub Actions、GitLab CI 或其他 CI 平台中，可以这样使用：
env: COMPOSER_MIRROR_PATH_REPOS: 1steps:
name: Checkout private package uses: actions/checkout@v3 with: repository: your-org/my-private-package path: ../my-private-package
name: Install dependencies run: composer install --prefer-dist
只要路径结构与 path 仓库定义一致，Composer 就能自动识别并使用本地副本，无需发布到私有仓库或打 tag。
基本上就这些。开启 COMPOSER_MIRROR_PATH_REPOS 后，本地 path 包会被当作已发布的 dist 包处理，既提升了构建速度，又保持了部署一致性。不复杂但容易忽略。
