Composer 无法真正忽略超时,设为0即禁用但极不推荐;真正控制超时的三个参数是 process-timeout、http.timeout 和 http-basic-timeout,需按场景分别设置并同步调高,优先换国内镜像更稳妥。

不能真正“忽略超时限制”,只能设为 0 禁用——但极不推荐,容易卡死无响应。 Composer 没有“忽略超时”的开关,所有 timeout 参数设为 0 表示禁用超时检查,进程会无限等待,直到网络彻底断开或被外层系统(如 Docker、CI 超时机制)强制杀死。
为什么 --ignore-platform-reqs 不起作用
这个参数只跳过 PHP 版本、扩展(如 ext-zip)等平台约束,和网络或子进程超时完全无关。它不会影响 process-timeout、http.timeout 或 http-basic-timeout 的任何行为。常见误判是看到报错里有 “platform requirements” 就加这个,结果下载阶段依然卡在 cURL error 28。
真正控制超时的三个独立参数
它们互不覆盖,必须按场景分别设置:
-
process-timeout:管git clone、unzip、php -r这类外部命令,单位秒,默认300 -
http.timeout(Composer 2.x):管 DNS 解析 + TLS 握手 + 首字节 + 整个 body 传输总时间,默认300 -
http-basic-timeout(Composer 2.2+):专管单次 HTTP 请求(比如拉 ZIP),默认60,旧版本不支持
只调高其中一个,大概率仍失败。例如大 ZIP 包下载慢,process-timeout 再大也没用——卡在 http-basic-timeout 上就直接断了。
设为 0 的风险与替代方案
运行 composer config -g process-timeout 0 或 COMPOSER_PROCESS_TIMEOUT=0 composer install 后,一旦镜像不可用或代理挂起,进程会永远卡住,不输出、不退出、不报错。
更稳妥的做法是:
- 优先换国内镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 同步调高两个关键值:
composer config -g process-timeout 1800和composer config -g http-basic-timeout 300 - 临时调试用命令行参数:
composer install --timeout=1200 --http-basic-timeout=240(注意--timeout=必须带等号) - 确认 PHP CLI 的
default_socket_timeout≥ 你设的 HTTP 超时值(用php -i | grep default_socket_timeout查)
超时配置不是万能解药。如果反复失败,大概率是镜像同步延迟、代理不支持 Range 请求,或公司防火墙主动中断长连接——这时候加 timeout 只是在等一个注定失败的结果。


















