利用Composer插件实现自动化镜像测速与智能切换-composer-PHP中文网

composer无原生镜像测速机制，所谓“自动选最快”插件实为外部shell脚本；prestissimo已废弃且不支持composer 2.x；推荐用环境变量composer_repo_packagist动态切换镜像源。

利用composer插件实现自动化镜像测速与智能切换

Composer 本身不提供插件机制来实现镜像测速或自动切换——所有所谓“自动选最快”的插件，要么已废弃，要么本质是外部脚本包装器，不能真正嵌入 Composer 运行时逻辑。

prestissimo 插件早就不支持 Composer 2.x，且从不测速

prestissimo 曾在 Composer 1.x 时代通过多线程加速下载，但它从未具备测速能力，也不参与源选择。它只在源确定后加速下载。Composer 2.x 已原生支持 parallel-downloads，prestissimo 不仅失效，还会引发冲突报错：Class Prestissimo\Plugin not found 或 Plugin installation failed。别再尝试 composer global require hirak/prestissimo，它对 Composer ≥2.2 完全无效。

所谓“自动切换插件”其实是 shell 脚本的马甲

目前 GitHub 上标榜 “auto-mirror”、“fastest-source” 的 Composer 插件，99% 是以下结构：

用 curl -o /dev/null -s -w '%{time_total}\n' 测几个固定镜像的 packages.json 响应时间
取最小值后执行 composer config -g repo.packagist composer <url></url>
最后调用 composer install —— 这一步才是真·Composer，前面全是 shell

这类工具的问题很实际：

测的是元数据响应，不是 ZIP 包下载速度，更不代表 composer update 全流程体验
镜像同步延迟（如新 tag 发布后阿里云约滞后 1–3 分钟）会导致 Package not found，测速再快也白搭
脚本无法感知 DNS 缓存、CDN 节点漂移、或公司出口策略拦截（比如强制解析 mirrors.aliyun.com 到海外 IP）

真正可控的自动化：纯 shell + 环境变量注入

绕过配置污染和权限陷阱，推荐用轻量 shell 脚本动态控制源，核心就三步：

Discussion Composer

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

下载

用 COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install 临时覆盖，不写磁盘
搭配 COMPOSER_CACHE_DIR=/tmp/composer-cache-$$ 避免旧缓存干扰
加 --no-plugins 防止第三方插件篡改源行为（某些企业内网插件会强行重写 repo.packagist）

示例最小可行脚本（保存为 fast-install）：

#!/bin/bash
MIRRORS=(
  "https://mirrors.aliyun.com/composer/"
  "https://mirrors.tuna.tsinghua.edu.cn/composer/"
  "https://mirrors.cloud.tencent.com/composer/"
)
BEST=""
MIN_TIME=999
for url in "${MIRRORS[@]}"; do
  t=$(curl -I -s -o /dev/null -w '%{time_total}' "$url"packages.json 2>/dev/null | cut -d. -f1)
  [ "$t" -lt "$MIN_TIME" ] && { MIN_TIME=$t; BEST=$url; }
done
[ -n "$BEST" ] && COMPOSER_REPO_PACKAGIST="$BEST" COMPOSER_CACHE_DIR="/tmp/composer-$$" composer install --no-plugins "$@"

注意：packages.json 后必须手动拼接，因为 curl 不会自动补尾部斜杠；cut -d. -f1 是粗略过滤小数点前整秒，避免浮点比较失败。

最容易被忽略的生效验证点

无论你用插件、脚本还是手动配置，最终是否真走镜像，只看这一行日志：

运行 composer install -vvv 2>&1 | grep "Reading packages.json from cache"，输出中必须含 /https---mirrors-aliyun-com-composer/ 这类路径。如果看到的是 /https---packagist-org/ 或路径里压根没镜像域名，说明配置没生效——大概率是项目级 composer.json 里写了 "repositories"，直接屏蔽了全局设置，此时得删掉它或显式设 "packagist.org": false。