卡在Downloading https://时应调http-basic-timeout(Composer 2.2+)或http.timeout(旧版),它控制DNS解析、TLS握手、首字节等待及整个body传输的总时间,默认仅60秒,弱网下极易超时,需同步调高PHP的default_socket_timeout。

卡在 Downloading https:// 该调哪个 timeout
这是 HTTP 请求阶段卡死,比如拉 packages.json、下载 ZIP 包,错误里常带 cURL error 28 或反复 retry 后失败。它完全不看 process-timeout。
http-basic-timeout(Composer 2.2+)或 http.timeout(旧版)控制单次请求全过程:DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输,单位秒。默认仅 60 秒,国内高延迟下根本不够用。
- 项目级写入:
composer config http-basic-timeout 600,会存进composer.json的config段,可提交、可复现 - 全局生效:
composer config -g http-basic-timeout 600,写入~/.composer/config.json - 临时覆盖(CI 调试最稳):
COMPOSER_HTTP_TIMEOUT=1200 composer install - ⚠️ 注意:
php -i | grep default_socket_timeout查出的值若低于你设的 timeout(常见是 60),PHP 底层会提前掐断连接,必须同步调高
The process timed out 错误该改什么
这是子进程执行太久被杀,比如 git clone、unzip、跑 post-install-cmd 脚本。错误里一定含 [RuntimeException] The process "" exceeded the timeout,加 -vvv 可看到最后那条命令。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
process-timeout 控制单个外部命令最大执行时间,默认 300 秒,和 HTTP 完全无关。
- 项目级改:直接在
composer.json顶层加"config": {"process-timeout": 1800} - 全局改:
composer config -g process-timeout 1800 - 临时覆盖:
COMPOSER_PROCESS_TIMEOUT=1800 composer install或--process-timeout=1800 - 设为 0 表示禁用超时,但可能卡死无响应;调试建议先设 600,确认能走通再调高
为什么只调一个 timeout 还是失败
因为 http-basic-timeout 和 process-timeout 管的是两个完全不重叠的阶段:前者管每个 HTTP 请求(哪怕只剩 1KB 没传完),后者管解压、脚本执行、autoload 生成等全部后续动作。只改一个,大概率白调。
- 弱网或大项目必须双开:
http-basic-timeout≥ 600,process-timeout≥ 1800 - CI 中推荐环境变量双保险:
COMPOSER_HTTP_TIMEOUT=1200 COMPOSER_PROCESS_TIMEOUT=1800 composer install - 注意:
"type": "git"的包会绕过镜像直连 GitHub,此时只能靠process-timeout+ Git 自身配置(如git config --global http.postBuffer 524288000)
换镜像源比加 timeout 更治本
80% 的 “超时” 实质是源不稳定,不是你网络差。阿里云镜像能绕过 DNS 污染、TLS 握手抖动和 packagist.org 响应延迟。
- 全局换源:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 配完必须清缓存:
composer clear-cache,否则仍可能读损坏的本地缓存 - 验证是否生效:
composer config -g repo.packagist应输出对应 URL;composer install --dry-run中下载链接要变成mirrors.aliyun.com - ⚠️ 注意:某些项目硬编码了
repositories字段,会覆盖全局配置,得手动检查并清理冗余项
default_socket_timeout 和镜像源对 git 类包的无效性——这两点不处理,光调 timeout 就像给漏水的桶拼命加水。

















