composer国内镜像对大zip包下载有效，但仅限已镜像收录的包；阿里云、华为云等对主流包的dist zip做了全量镜像与cdn加速，实测20mb+包下载达8–12 mb/s，未收录则fallback至github原始链接。
Composer国内镜像对大ZIP包下载是否真有效
有效，但仅限“下载”环节——镜像源加速的是 https://mirrors.aliyun.com/composer/ 或 https://mirrors.huaweicloud.com/repository/php/composer/ 上托管的 dist ZIP 包，不加速 GitHub/GitLab 原始仓库（如 https://github.com/symfony/console/archive/refs/tags/v6.4.0.zip）。真正影响大文件体验的，是镜像是否缓存了这些 ZIP、是否启用 CDN、以及是否支持 HTTP/2 和 Range 请求。
阿里云、华为云镜像均对主流包（Laravel、Symfony、Monolog 等）的 dist ZIP 做了全量镜像和 CDN 加速，实测 20MB+ 的 laravel/framework ZIP 下载速度可达 8–12 MB/s（千兆内网），远高于直连 GitHub 的 1–3 MB/s。但若某包未被镜像收录（如极新 release 或私有包），Composer 会 fallback 到原始 URL，此时仍卡在海外链路。
- 验证是否走镜像：加
-vvv运行composer install，日志中出现Downloading https://mirrors.aliyun.com/composer/dist/xxx.zip才算真正命中 - 镜像未收录时，日志显示
Downloading https://api.github.com/...或Downloading https://codeload.github.com/...，说明仍在走原始源 - 华为云镜像路径必须带
/repository/php/composer/，少这段会导致 ZIP 404，而非 fallback —— 这是常见静默失败点
为什么大包下载仍卡在 “Downloading” 且无进度
不是镜像慢，而是 PHP cURL 库未启用进度回调或 Composer 未暴露底层状态。尤其在低配 VPS（512MB 内存）上，file_put_contents() 写入大 ZIP 时若 tmpfs /tmp 满或磁盘 I/O 饱和，cURL 会阻塞但不报错，表现为“假死”。
- 检查
/tmp空间：df -h /tmp，不足 500MB 就可能中断（一个 Laravel ZIP 解压后常占 300MB+） - 临时改写缓存目录避免 /tmp 压力：
COMPOSER_CACHE_DIR=/home/www/cache composer install - 禁用 xdebug（
php -d xdebug.mode=off $(which composer) install），否则大文件流式写入会因调试器 hook 变慢 3–5 倍 - 不要依赖
--verbose看进度：它只打印包名，不刷新字节数；-vvv也只在完成时输出大小，无实时流式反馈
parallel-downloads 对大文件并发下载的实际影响
它控制的是「同时发起多少个 HTTP 下载请求」，不是「单个 ZIP 分片下载」。设为 10 并不意味一个 50MB 包被切成 10 份并行拉，而是最多同时拉 10 个不同包的 ZIP。对单一大包无效，但能显著缩短含多个大依赖（如 doctrine/orm + symfony/framework-bundle + laravel/octane）的整体耗时。
- 默认值 3 → 同时最多下 3 个 ZIP，其余排队；设为 8–10 后，10 个大包可基本“齐头并进”
- 超过 10 易触发
file_put_contents(/tmp/): failed to open stream：低配机器 /tmp 内存盘容量小，大量临时文件竞争写入失败 -
http-max-concurrent-downloads是新版唯一有效配置项，parallel-downloads在 Composer 2.2+ 中已弃用但兼容；设了后者不报错也不生效 - 命令必须带
-g：否则只作用于当前项目，CI 构建或全局命令（如create-project）不受影响
大文件部署时最易忽略的三个硬性条件
镜像、并发、缓存三者都配对了，仍下载失败或超时，大概率栽在这三个物理层限制上：
-
memory_limit不足：PHP 默认 128M，解压 30MB ZIP 需至少 256M；生产部署建议显式加php -d memory_limit=512M composer install - 系统临时目录权限错误：Docker 或宝塔环境下，
/tmp可能被挂载为只读或属主非运行用户（如 www），导致 ZIP 写入失败且无明确报错 - HTTPS 证书验证耗时：内网部署时，
secure-http true会让 PHP 反复校验镜像站证书链，512MB 内存机器可能 OOM；可信环境应执行composer config -g secure-http false
大 ZIP 文件本身不复杂，复杂的是它把内存、磁盘、证书、权限这些底层问题一次性全暴露出来。配镜像只是起点，不是终点。
