Composer怎么配置最大超时等待时间提升成功率-composer-PHP中文网

Composer超时需同时配置http-basic-timeout（控制DNS/TLS/下载全过程，默认60秒）、process-timeout（控制git/unzip等子进程，默认300秒）及PHP的max_execution_time（针对自定义脚本），三者独立生效，缺一不可；优先切换国内镜像源治本。

composer怎么配置最大超时等待时间提升成功率

Composer 的“超时”不是单一参数，而是三层独立控制：HTTP 下载、子进程执行、PHP 脚本运行。只调一个，大概率还是失败。

卡在 Downloading https:// 该调 `http-basic-timeout`

错误现象常见为 cURL error 28、反复 retry 后失败，或卡在 Downloading https://repo.packagist.org/packages.json 这类行。这不是 process-timeout 在起作用，而是单次 HTTP 请求总耗时（DNS + TLS + 首字节 + body 传输）被掐断。

http-basic-timeout 默认仅 60 秒（Composer 2.1 及更早）或 300 秒（2.2+），弱网或大包极易触发
项目级生效：运行 composer config http-basic-timeout 300，写入当前 composer.json 的 config 段
全局生效：运行 composer config -g http-basic-timeout 300，写入 ~/.composer/config.json
临时覆盖优先级最高：设环境变量 COMPOSER_HTTP_TIMEOUT=600 再执行命令（注意：环境变量名是 COMPOSER_HTTP_TIMEOUT，不是 COMPOSER_HTTP_BASIC_TIMEOUT）
⚠️ 关键遗漏点：PHP CLI 的 default_socket_timeout 若低于你设的值（常见默认是 60），会提前中断连接。查它：php -i | grep default_socket_timeout，必要时同步调高（如通过 php -d default_socket_timeout=600 composer install）

报 The process "" exceeded the timeout 该调 `process-timeout`

错误信息里一定含 [RuntimeException] The process "" exceeded the timeout，加 -vvv 可看到最后卡在哪条命令上——比如 git clone、unzip、php scripts/post-install.php。这是子进程执行超限，和 HTTP 完全无关。

process-timeout 控制每个外部命令（非 PHP 主进程）的最大运行时间，默认 300 秒
项目级固化：在 composer.json 顶层加 "config": {"process-timeout": 1800}
全局统一：运行 composer config -g process-timeout 1800
临时覆盖：用 --process-timeout=1800（必须带等号）或环境变量 COMPOSER_PROCESS_TIMEOUT=1800
设为 0 表示禁用超时，但不推荐——一旦网络异常或磁盘满，进程会无限挂起，CI 流水线直接卡死

自定义脚本（post-install-cmd 等）超时由 PHP 控制

很多人在 composer.json 的 scripts 里写了耗时脚本，结果报 Maximum execution time of 300 seconds exceeded。这不是 Composer 配置能改的，是 PHP 自身机制在起作用。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

Composer 的 config.timeout 或 process-timeout 对它完全无效
最稳方式：调用前加 php -d max_execution_time=0，例如 php -d max_execution_time=0 composer install
若用 composer run-script，同样生效：php -d max_execution_time=900 composer run-script post-build
脚本内也可用 set_time_limit(0)，但必须尽早调用，且不能在 disable_functions 中被禁用

比调 timeout 更关键的是镜像和回源策略

很多“超时”本质是连不上 packagist.org，不是时间不够。国内用户不配镜像，调再大 timeout 也白搭。

必须切换国内镜像源，例如阿里云：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
禁用 packagist.org 回源（防止 fallback 到境外慢链）：composer config -g repos.packagist.org false
镜像配置优先级高于 timeout：哪怕你设了 --timeout=3600，没镜像照样卡在 DNS 解析或 TLS 握手阶段

真正容易被忽略的点是：三类 timeout（HTTP、process、PHP）各自独立，且受不同底层机制约束；环境变量优先级最高，但设为 0 有卡死风险；而所有 timeout 调整都压不过一个事实——没镜像，就等于没通路。