分析Composer镜像配置对部署速度的提升-composer-PHP中文网

单纯换 composer 镜像源仅加速元数据（如 packages.json）下载，不加速 zip 包（dist）下载；真正卡顿多因直连 github 的 dns 解析、tls 握手或连接重置，日志中出现 mirrors.aliyun.com/composer/ 仅说明元数据走镜像，而 github.com/codeload.github.com 请求仍走海外链路。

分析composer镜像配置对部署速度的提升

单纯换 Composer 镜像源，对部署速度的提升非常有限——它只加速元数据（packages.json、provider 列表）下载，不加速实际 zip 包（dist）的下载。真正卡住的环节，90% 是直连 github.com 或 codeload.github.com 时的 DNS 解析、TLS 握手或连接重置。

镜像源只管元数据，不管 dist 包路径

阿里云、腾讯云等 Composer 镜像只代理索引文件，所有 .zip 包仍从 GitHub 原地址下载。日志里反复出现：

Downloading https://api.github.com/...
Downloading https://codeload.github.com/...

→ 这说明镜像已生效（元数据飞快），但 dist 下载仍在走海外链路。

常见表现：

元数据加载秒级完成，某个包却卡住 30 秒以上
composer install -vvv 显示 mirrors.aliyun.com/composer/，但后续请求全是 github.com
即使 composer config -g repo.packagist 输出正确，速度也毫无改善

必须验证是否真走镜像：看日志，不是看命令输出

执行 composer install -vvv 后，grep 关键路径才是唯一可信判断：

composer install -vvv 2>&1 | grep "mirrors-aliyun"

真正生效的日志特征是：

Reading packages.json from cache at /home/user/.composer/cache/repo/https---mirrors-aliyun-com-composer/packages.json

Discussion Composer

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

下载

而不是只看到命令执行成功。容易踩的坑包括：

没加 --no-cache，旧缓存里的官方源元数据还在被读取
项目级 repositories 字段覆盖了全局配置，且未设 "packagist.org": false
CI 环境中以 runner 用户运行，但 -g 写进了 root 的 ~/.composer/config.json

Docker 和 CI 中必须显式传参，不能依赖全局配置

容器启动是全新上下文，宿主机的 ~/.composer/config.json 完全不可见。Dockerfile 中推荐写法：

RUN composer install --repository=https://mirrors.aliyun.com/composer/

这条命令语义清晰、可复现、不依赖任何外部状态。次选方案是：

RUN composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/

但必须确保三要素齐全：repo.packagist（不能多 s）、中间 composer（type 值）、URL 末尾 /（否则拼出 /composerpackages.json 导致 404）。

低配服务器上，镜像只是第一步，不是全部

512MB 内存机器上 composer install 卡住，根源常是物理链路不通（DNS/TLS 超时），而非网速慢。此时必须：

一步到位配镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
立刻清缓存：composer clear-cache（注意不是 cache-clear）
关掉 HTTPS 强制校验（仅限内网）：composer config -g secure-http false
安装时减负：composer install --prefer-dist --no-autoloader --no-scripts，完成后单独跑 composer dump-autoload

镜像配错一个字符就静默失效，而部署失败往往发生在最没防备的环节：比如 URL 少了个 /，或 repo.packagist 写成 repos.packagist——它不报错，也不提示，只是默默 fallback 回 packagist.org。