下载大包超时本质是HTTP层超时而非网速慢,需调高http-basic-timeout(v2.2+)或http.timeout(旧版)至300~600秒,并同步提升PHP的default_socket_timeout,同时推荐切换阿里云镜像以规避网络链路问题。

下载大包超时,本质不是“网速慢”,而是 Composer 默认的 http-basic-timeout(v2.2+)或 http.timeout(旧版)太短,且单次请求卡在首字节等待或 body 传输阶段就被掐断——哪怕你网络通畅,也扛不住默认 60 秒的限制。
看 -vvv 输出确认卡点是 Downloading https://
运行 composer install -vvv 或 composer update -vvv,盯住最后一行:
- 如果停在
Downloading https://...,说明是 HTTP 请求层超时,process-timeout完全不生效 - 如果停在
Executing command "git clone ...",那才是process-timeout的管辖范围 - 别靠猜:没看到
Downloading就别动http-basic-timeout
必须调 http-basic-timeout(或 http.timeout),不是 process-timeout
process-timeout 控的是整个命令生命周期(含解压、脚本、autoload),对单个 ZIP 包下载失败没用。真正管下载大包的是 HTTP 层 timeout:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- Composer 2.2+:用
http-basic-timeout,单位秒,建议设为300~600 - 旧版 Composer:用
http.timeout,同样设为300~600 - 临时覆盖:加参数
--http-basic-timeout=480(仅 v2.2+) - 永久生效:
composer config -g http-basic-timeout 480
PHP 的 default_socket_timeout 必须同步调高
即使你把 http-basic-timeout 设成 600,如果 PHP CLI 的 default_socket_timeout 是默认的 60,cURL 还是会在 60 秒被底层掐断:
- 查当前值:
php -i | grep default_socket_timeout - 临时改(推荐):
php -d default_socket_timeout=600 composer install - 永久改:编辑
php.ini中的default_socket_timeout = 600 - 注意:这个值必须 ≥ 你设的
http-basic-timeout,否则白配
换阿里云镜像比加 timeout 更治本
国内用户 80% 的“大包超时”实际是源不稳定导致的首字节延迟高、TLS 握手抖动或 DNS 污染——换镜像能绕过这些链路问题:
- 设镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 清缓存:
composer clear-cache(否则可能继续读损坏的本地缓存) - 验证是否生效:
composer config -g repo.packagist应输出阿里云地址;composer install --dry-run中的下载链接也得变成mirrors.aliyun.com - 注意:
"type": "git"的包仍直连 GitHub,此时要靠process-timeout和 Git 自身配置兜底
最麻烦的从来不是“等多久”,而是中断后 vendor/ 下那些校验失败却没被自动清理的破损 ZIP ——它们不会报错,但会持续触发 Failed to extract 或 Content-Length mismatch,必须手动 composer clear-cache 才能真正重来。

















