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

不是网速问题,是 Composer 自己设了两道独立超时关卡,只调一个根本过不去。
卡在 Downloading https:// 该调哪个 timeout
这是 HTTP 请求传输阶段卡住,错误里常带 cURL error 28 或 failed to open stream: Connection timed out。它只响应 http-basic-timeout(Composer 2.2+)或旧版的 http.timeout,和 process-timeout 完全无关。
-
http-basic-timeout控制单次 GET 的全过程:DNS 解析、TLS 握手、首字节等待、整个 body 下载,默认仅 60 秒 —— 国内首字节延迟动辄 200ms,根本撑不住 - 临时调试优先用命令行参数:
composer install --http-basic-timeout=300(注意:仅 Composer 2.2+ 支持) - 永久生效写全局配置:
composer config -g http-basic-timeout 300 - PHP CLI 的
default_socket_timeout必须 ≥ 你设的值(查法:php -i | grep default_socket_timeout),否则底层 socket 会在 60 秒就掐断连接
报 The process "" exceeded the timeout 该调哪项
错误里明确含 [RuntimeException] The process "" exceeded the timeout,说明是子进程执行超时,比如 unzip 解压大 ZIP、git clone 私仓、或跑 post-install-cmd 脚本太久。
- 这个阶段由
process-timeout控制,默认 300 秒,和 HTTP 完全无关 - 项目级生效:
composer config process-timeout 1800(写入当前composer.json的config段) - 全局生效:
composer config -g process-timeout 1800(写入~/.composer/config.json) - 临时覆盖优先级最高:
COMPOSER_PROCESS_TIMEOUT=2000 composer install - 设为 0 表示禁用超时,但不推荐长期使用——网络卡死时会无限挂起
为什么只改一个 timeout 还是失败
因为 process-timeout 和 http-basic-timeout 是两条完全独立的路径:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
process-timeout管的是外部命令生命周期(如git clone、unzip),不延长单次 HTTP 连接 -
http-basic-timeout管的是每个 GET 请求(哪怕 ZIP 差最后 1 字节没传完也会中断),不影响git clone耗时 - 两者不叠加、不可替代;只调其一,换再多次镜像也白搭
- 典型症状:
composer install -vvv最后一行停在Downloading https://...→ 必须调http-basic-timeout;停在Cloning into 'xxx'...或解压阶段 → 必须调process-timeout
换镜像比加 timeout 更治本
80% 的 “超时” 其实是源不稳定导致的连接抖动或首包延迟高,不是带宽问题。阿里云镜像能绕过 DNS 污染、TLS 握手抖动和国外源响应延迟。
- 设镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 必须清缓存:
composer clear-cache,否则仍可能读损坏的本地 ZIP - 验证是否生效:
composer config -g repo.packagist应输出对应 URL,且composer install --dry-run中下载链接要变成mirrors.aliyun.com - 注意:
"type": "git"的包会绕过镜像直连 GitHub,此时需额外配 Git 超时或强制走 HTTPS
真正容易被忽略的是:超时配置只是“等得更久”,不能解决镜像同步延迟、代理空闲超时、CA 证书拦截或 PHP 缺失 openssl 扩展这些底层问题。先确认 curl -I https://mirrors.aliyun.com/composer/packages.json 能通,再调 timeout 才有意义。










