Composer无自动测速与自适应timeout,需用curl测镜像源响应时间后动态设置--http-timeout;--timeout已弃用,--process-timeout不控制HTTP下载;PHP socket超时也需同步调高。

Composer 没有内置“自动测速+自适应 timeout”的能力,--timeout 和 --http-timeout 都是静态值,必须由你外部判断网络状况后手动传入。所谓“灵活”,本质是写个 wrapper 脚本做决策,不是改配置就能生效。
区分 --timeout 和 --http-timeout:别用错参数
这两个参数控制完全不同的阶段,混用会导致调了也没效果:
-
--timeout(旧版叫法,2.x 后已弃用)→ 实际对应的是--http-timeout,只管 HTTP(S) 请求全过程:DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输。单位秒,支持小数(如--http-timeout=1.5)。 -
--process-timeout管的是子进程,比如git clone、unzip、post-install-cmd 脚本。和网络下载无关,设再大也救不了卡在Downloading https://...的情况。 - 错误信息里带
cURL error 28或反复 retry → 一定是--http-timeout不够,不是--process-timeout。
用 curl 测源站响应时间,决定 http-timeout 值
别用 ping,ICMP 不代表 HTTPS 可通,且国内多数 CDN 屏蔽 ping。真实有效的方法是模拟 Composer 实际请求行为:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 测镜像源(推荐阿里):
curl -o /dev/null -s -w "%{time_total}\n" https://mirrors.aliyun.com/composer/packages.json -m 5 - 输出值如
2.34,说明首包耗时 2.34 秒;若超 5 秒或返回空,说明源不可达或被拦截,应 fallback 到备用源或更高 timeout。 - 经验阈值:响应 --http-timeout=300;1–3s →
--http-timeout=600;>3s 或不稳定 →--http-timeout=900或换源。 - 脚本中务必加
||fallback,例如:timeout_val=$(curl ... 2>/dev/null || echo 900),避免测速失败导致命令中断。
全局配置 + wrapper 脚本才是唯一实用方案
你不能靠 composer.json 里的 "timeout": 600 生效——这字段根本不受 Composer 识别。真正可落地的方式只有两种:
- 全局写死(适合稳定环境):
composer config -g http.timeout 600,会写入~/.composer/config.json的"http": {"timeout": 600}节点。 - 动态 wrapper(推荐 CI/国内用户):写个 shell 函数或脚本,先
curl测速,再拼接composer update --http-timeout=$timeout_val执行。示例片段:#!/bin/bash<br>url="https://mirrors.aliyun.com/composer/packages.json"<br>rt=$(curl -o /dev/null -s -w "%{time_total}" "$url" -m 5 2>/dev/null)<br>timeout_val=$(awk -v t="$rt" 'BEGIN{if(t>3) print 900; else if(t>1) print 600; else print 300}')<br>composer update --http-timeout="$timeout_val" "$@" - 注意 PHP 自身限制:
php -i | grep default_socket_timeout若输出60,必须同步调高,否则 Composer 设再大也会被 PHP 底层掐断。
最常被忽略的一点:镜像源只加速 Packagist 公共包,对 repositories 里硬编码的 GitHub/GitLab 私仓、git@ 地址完全无效。这类源的超时必须单独测、单独设,不能依赖统一 wrapper。










