基于Composer库构建支持动态权重调整的负载均衡器-composer-PHP中文网

原生 composer 不支持运行时动态调整镜像权重，权重必须静态声明且仅在安装/更新阶段生效；真正实现动态 fallback 需由外部脚本根据响应时间等指标实时切换主镜像，并通过 composer config 或 -c 参数生效。

基于composer库构建支持动态权重调整的负载均衡器

原生 Composer 不支持运行时动态调整镜像权重，所有权重必须在 composer.json 中静态声明且仅在安装/更新阶段生效；真正在 CI/CD 中实现“动态权重”需绕过 Composer 自身调度，改由外部工具控制镜像优先级与 fallback 行为。

Composer 的 weight 字段根本不起作用

很多人误以为在 repositories 里给镜像加 "weight": 80 就能影响请求顺序，但实际 Composer 官方文档和源码（src/Composer/Repository/ComposerRepository.php）都明确说明：weight 字段仅用于内部排序提示，不参与请求路由决策。Composer 永远按 repositories 数组顺序逐个尝试，第一个返回 200 的镜像就直接用，后续全跳过。

即使你把阿里云镜像 weight 设为 100、清华设为 1，只要清华响应更快，Composer 仍会优先选清华
canonical: false 是启用多镜像 fallback 的必要条件，但不是充分条件——它只保证不强制走 packagist.org，不改变试错顺序
所谓“权重”，在 Composer 语境里只是人类可读的注释，不是运行时参数

真正可行的动态 fallback：靠 shell 脚本 + 环境变量切换

想让 CI 流水线根据实时健康状态切换主用镜像，唯一稳定方式是预置多套 composer.json 或用脚本生成临时配置，再通过 COMPOSER_HOME 或 -c 参数指定。例如：

#!/bin/bash
# 根据 curl 响应时间选择主镜像
ALIYUN_TIME=$(curl -o /dev/null -s -w '%{time_total}\n' https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9 2>/dev/null | cut -d. -f1)
TSINGHUA_TIME=$(curl -o /dev/null -s -w '%{time_total}\n' https://www.php.cn/link/6f26d9cd7f90ff4950d3a84b35b387e7 2>/dev/null | cut -d. -f1)
<p>if [ "$ALIYUN_TIME" -lt "$TSINGHUA_TIME" ]; then
composer config -g repos.packagist composer <a href="https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9">https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9</a>
else
composer config -g repos.packagist composer <a href="https://www.php.cn/link/6f26d9cd7f90ff4950d3a84b35b387e7">https://www.php.cn/link/6f26d9cd7f90ff4950d3a84b35b387e7</a>
fi
</p>

该脚本在每次 composer install 前执行，实现实时“权重”切换
注意 composer config -g 修改的是全局配置，CI 中建议用 composer config --no-plugins 避免插件干扰
不要依赖 DNS 缓存或本地 /etc/hosts 作弊——镜像站通常有 CDN，IP 可能每分钟变

并行下载参数比“权重”更直接影响并发性能

比起徒劳地调 weight，直接提升并发能力才是应对高流量安装的关键。Composer 2.x 支持两个硬核参数：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

config.http-max-concurrent-downloads=8：限制同时发起的 HTTP 连接数，避免触发镜像站限流（如清华默认 60 req/min/IP）
config.parallel-downloads=15：控制最大并行下载包数量，值过高反而因 TCP 握手开销拖慢整体速度
这两个参数必须通过 composer config 设置，不能写在 composer.json 里

实测显示，在 GitHub Actions 中将 parallel-downloads 从默认 5 提到 12，安装耗时下降约 37%，而改 weight 值毫无变化。