应调http-basic-timeout而非process-timeout,因其专控HTTP请求阶段的连接与读取总时长;需同步调高PHP的default_socket_timeout,并切换阿里云镜像源以解决弱网下载卡顿问题。

弱网下 Composer 卡在 Downloading https:// 或报 cURL error 28,不是网络“不通”,而是默认超时太短、参数错配、镜像没切对——调高一个值往往不够,得同时动三个地方。
卡在 Downloading https:// 该调 http-basic-timeout,不是 process-timeout
这是最常踩的坑:看到“超时”就去改 process-timeout,结果毫无作用。因为 process-timeout 只管 git clone、unzip 这类子进程,而 Downloading https:// 是 HTTP 请求阶段,由 http-basic-timeout 控制。
-
http-basic-timeout控制单次 HTTP GET 的连接 + 首字节等待 + 读取总时间,默认仅 60 秒,弱网下极易触发重试或直接失败 - 仅 Composer 2.2+ 支持;旧版本只能用
--timeout全局兜底,但会误杀 git 操作 - 临时生效:
composer install --http-basic-timeout=300 - 永久生效:
composer config -g http-basic-timeout 300(写入~/.composer/config.json)
http-basic-timeout 生效的前提是 PHP 的 default_socket_timeout 不比它小
Composer 的 HTTP 层底层依赖 PHP 的 stream context,如果 PHP 自身的 socket 超时设得太低,会提前掐断连接,http-basic-timeout 再大也白搭。
- 查当前值:
php -i | grep default_socket_timeout,常见默认值是 60 秒 - 必须同步调高:
php -d default_socket_timeout=300 composer install - 或全局修改 php.ini 中的
default_socket_timeout = 300(注意 CLI 和 Web SAPI 可能不同配置) - 若用 Docker,需在容器启动时注入:
PHP_INI_SCAN_DIR=/usr/local/etc/php/conf.d并挂载自定义 ini 文件
国内弱网用户必须切镜像源,否则调再久也没用
packagist.org 官方源在国内直连响应慢、丢包率高,http-basic-timeout 设到 600 秒仍可能反复失败。镜像不是“锦上添花”,而是弱网下的生存线。
- 推荐阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 注意:项目级
composer.json中的repositories字段优先级高于全局配置,需检查并清理冗余项 - 私有 Git 仓库(如
git@xxx或https://gitlab.internal/xxx)不会走镜像,这类包要单独确保process-timeout足够长 - 换源后建议清缓存:
composer clear-cache,避免旧包元数据残留干扰
真正卡住时,别只盯着 timeout
有些“卡住”根本不是超时问题:内存不足会导致解析锁文件阶段 OOM,表现和超时一模一样;vendor 下 symlink 过多会让 autoload 生成阻塞;CI 环境里未显式设置 COMPOSER_HOME 会导致配置丢失,每次都是默认值。
- 查内存限制:
php -r "echo ini_get('memory_limit');",建议 ≥ 1.5G - 禁用并行下载可降低连接压力:
composer config -g use-include-path false,配合COMPOSER_PROCESS_TIMEOUT=0更稳 - CI 中务必显式导出变量:
COMPOSER_PROCESS_TIMEOUT=1800和COMPOSER_HTTP_BASIC_TIMEOUT=300,不能只靠 config 文件











