COMPOSER_MIRROR_PATH_REPOS 是启用 Composer 路径镜像仓库机制的环境变量，设为1时允许读取本地 path 类型仓库中的 packages.json；未设置或为0则静默忽略该类仓库。
COMPOSER_MIRROR_PATH_REPOS 是什么
它是一个环境变量，用于启用 Composer 的「路径镜像仓库」（path repository mirroring）机制，本质是让 Composer 把本地文件系统路径当作可搜索的 Composer 仓库来用——但仅当该路径下存在合法的 packages.json 文件时才生效。
这个变量本身不定义镜像地址，也不替换源；它只是打开一个开关：告诉 Composer 在解析包时，允许把 repositories 中 type 为 path 的仓库，按实际文件路径去读取元数据，而不是跳过或报错。没有它，type: "path" 仓库默认被忽略（尤其在某些旧版或严格模式下）。
为什么需要显式开启 COMPOSER_MIRROR_PATH_REPOS=1
Composer 默认禁用本地路径仓库的自动识别，出于安全考虑：防止意外加载未审核的本地代码。开启后，它才会真正尝试读取你配置的 path 目录下的 packages.json，并据此解析包版本、下载 ZIP 或源码。
- 不设该变量 → 即使
composer.json里写了"type": "path", "url": "./my-local-packages"，Composer 也会静默跳过，报错时可能只显示“Package not found”，不提示路径被忽略 - 设为
1或true→ Composer 尝试读取./my-local-packages/packages.json，若结构正确（含packages字段），就能命中本地包 - 设为
0或未设置 → 等同于关闭，无论配置如何都无视path类型仓库
典型使用场景和配置要点
常见于离线开发、私有包快速验证、CI 流水线中复用构建产物。关键不是“怎么写变量”，而是整个链路必须闭环：
-
packages.json必须由工具生成（如composer-satis或toran-proxy），不能手写；手动拼的 JSON 极易字段缺失或格式错误，导致 Composer 解析失败但不报具体原因 -
url值必须是相对或绝对路径，且以/结尾（如"./mirror/"），否则 Composer 会拼接出错误的packages.json路径 - 路径仓库不支持
only/exclude过滤，所有包都会被索引；若只想暴露部分包，得在生成packages.json时就过滤好 - 运行命令前务必确认当前工作目录 —— 因为
./mirror/是相对于执行composer install的位置，不是相对于composer.json
容易踩的坑
最常被忽略的是权限与路径解析细节：
- Linux/macOS 下路径区分大小写，
./Mirror/和./mirror/是两个不同目录；Windows 虽不敏感，但 Composer 内部仍按大小写匹配字段名 -
packages.json文件必须可读，且所在目录对运行 Composer 的用户有执行（x）权限（Linux/macOS），否则报Could not open input file而非权限错误 - 即使开了
COMPOSER_MIRROR_PATH_REPOS=1，如果composer.json里repositories没写"type": "path"，变量也完全不起作用 - 该变量不影响
type: "composer"的 HTTP 镜像源，只对path类型生效；别指望它能加速阿里云镜像
真正起效的标志是运行 composer config repositories 能看到你的 path 条目，且 composer update -vvv 日志里出现 Reading packages.json from ./mirror/packages.json —— 其他都是假象。
