卡在Downloading https://时应优先调http.timeout(控制DNS、TLS、首字节及完整body下载,建议1200秒),而非http-basic-timeout;后者仅管单次GET连接与读取(建议300秒),适用于握手慢场景,两者不可混用且须同步调高PHP default_socket_timeout。

直接说结论:没有“通用合理值”,必须按阶段拆解、分场景设值,且要和 PHP 底层超时对齐,否则白调。
卡在 Downloading https:// 时该调 http.timeout 还是 http-basic-timeout?
这是两个不同层级的超时,不能混用:
-
http.timeout控制整个 HTTPS 请求生命周期(DNS + TLS 握手 + 首字节等待 + 完整 body 下载),默认仅 300 秒;弱网下拉一个 200MB 的 dist ZIP 很容易超时,建议设为1200(20 分钟) -
http-basic-timeout(Composer 2.2+ 才有)只管单次 GET 的连接和读取(比如拉packages.json或 ZIP 包头几 KB),不涉及整个 body,适合设为300防握手慢中断 - 如果错误里出现
cURL error 28或反复 retry 后失败,且卡点明确在Downloading https://...,优先调http.timeout;若卡在“正在获取包列表”或镜像源响应极慢,http-basic-timeout更关键
process-timeout 设太高反而会掩盖真实问题
它控制的是 unzip、git clone、tar -xzf 这类子进程的执行上限,默认 300 秒。但注意:
- 设成
0(不限时)风险高:一旦 zip 损坏或磁盘满,命令会永远卡住,无日志、无退出 - CI 环境建议设为
1800(30 分钟),既留足余量,又能在真出问题时及时暴露(比如私有仓库 DNS 解析失败) - 本地开发设
900足够;若经常触发,别急着再加,先composer install -vvv看最后执行的是哪条命令——可能是你某个 post-install-cmd 脚本本身写得低效
为什么改了 composer.json 里的 config.timeout 没用?
因为这个字段根本不存在。Composer 不识别 config.timeout —— 这是早年过时文档遗留的错误写法。
真正起效的只有三个独立配置项:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
-
http.timeout:只能通过composer config http.timeout 1200(项目级)或composer config -g http.timeout 1200(全局)设置;不能写进composer.json的config段 -
process-timeout和http-basic-timeout可以写进composer.json的config,例如:{"config": {"process-timeout": 1200, "http-basic-timeout": 300}} - 临时覆盖优先级最高:用环境变量,如
COMPOSER_HTTP_TIMEOUT=1200 COMPOSER_PROCESS_TIMEOUT=1800 composer install
PHP 底层 default_socket_timeout 必须同步调高
哪怕你把 http.timeout 设成 3600,只要 PHP CLI 的 default_socket_timeout 是默认的 60 秒,cURL 就会在 60 秒后直接报错,http.timeout 根本没机会生效。
检查方式:php -i | grep default_socket_timeout;修改方式:
- 临时:启动时加参数
php -d default_socket_timeout=1200 composer install - 永久:改
php.ini中的default_socket_timeout = 1200(注意是 CLI 模式下的 php.ini,不是 Web 用的那个)
最容易被忽略的一点:所有 timeout 都是“层层嵌套”的——PHP socket 层 → Composer HTTP 层 → Composer process 层。少调一层,就可能在某处静默中断,连错误信息都不完整。










