卡在Downloading https://应调http-basic-timeout(Composer 2.2+)或http.timeout(旧版),二者均控制DNS、TLS、首字节及body传输全过程,默认值过低易超时,且必须同步调高PHP的default_socket_timeout。

直接设 http.timeout 或 http-basic-timeout,别碰 timeout 字段——它在 composer.json 里完全不生效。
卡在 Downloading https:// 该调哪个参数
这是单次 HTTPS 请求全过程超时,包括 DNS 解析、TLS 握手、首字节等待、整个 ZIP body 传输。错误里常见 cURL error 28 或反复 retry 后失败。
- Composer 2.2+ 推荐用
http-basic-timeout(专管每个 GET 请求的连接+读取) - 旧版或兼容场景用
http.timeout(控制整条请求生命周期) -
process-timeout完全不参与——它只管git clone、unzip这类子进程 -
config.timeout是无效字段,写进composer.json的config段会被忽略
为什么设了还是超时?PHP 底层 socket 在掐你
http.timeout 再大也白搭,只要 PHP CLI 的 default_socket_timeout 更小,cURL 就会在那个值触发时直接报错。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 查当前值:
php -i | grep default_socket_timeout - 临时改(CI 推荐):
php -d default_socket_timeout=1200 composer install - 永久改:编辑
php.ini,设default_socket_timeout = 1200,重启 CLI 环境 - 两者必须同时 ≥ 你期望的 HTTP 超时值,否则底层提前断连
项目级、全局、临时设置怎么选
三者优先级:环境变量 > 项目级配置 > 全局配置。日常开发建议项目级固化,CI 环境用环境变量兜底。
- 项目级(可提交、可复现):
composer config http-basic-timeout 600,写入当前composer.json的config段 - 全局(影响所有项目):
composer config -g http-basic-timeout 600,写入~/.composer/config.json - 临时覆盖(最高优先级):
COMPOSER_HTTP_TIMEOUT=1200 composer install或COMPOSER_HTTP_BASIC_TIMEOUT=1200 composer install
真正容易被忽略的是:HTTP 超时只是第一道关,unzip 和 git clone 阶段还会再卡一次,那得靠 process-timeout;而国内用户不切镜像源,光调 timeout 基本没用。










