Composer超时需先定位卡点：卡在Downloading则调http.timeout（控制DNS+TLS+下载全程），卡在Executing command则调process-timeout（控制git/unzip等子进程）；二者默认均300秒，弱网或大项目须同步调高，且国内用户必须配置镜像源。
Composer 请求接口超时，不是“调大 timeout 就完事”，而是得先分清卡在哪一环：是连不上服务器（连接超时），还是连上了但等不到响应（读取超时），又或是下载 ZIP 包中途断、解压卡死、脚本跑太久——每种情况对应完全不同的配置项，混用等于白调。
卡在 Downloading https://xxx.zip？重点调 http.timeout
这是最常见现象，错误里带 cURL error 28 或反复 retry 后失败。它只跟 HTTP 下载过程有关，和 git、unzip、PHP 脚本执行全无关系。
-
http.timeout控制 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输的总耗时，默认仅 300 秒（Composer 2.1+）或更早版本可能低至 60 秒 - 项目级生效（推荐）：
composer config http.timeout 600，写入当前composer.json的config段，可提交、可复现 - 全局生效：
composer config -g http.timeout 600，写入~/.composer/config.json - 临时覆盖（CI 调试首选）：
COMPOSER_HTTP_TIMEOUT=1200 composer install - ⚠️ 关键检查：
php -i | grep default_socket_timeout，若输出值（如 60）小于你设的http.timeout，PHP 底层会提前掐断，必须同步调高该 ini 值
报 The process timed out？盯死 process-timeout
错误信息明确含 The process "" exceeded the timeout，且加 -vvv 能看到最后执行的命令（比如 git clone、unzip、php xxx.php），这就是子进程超时，和 HTTP 完全无关。
-
process-timeout控制单个外部命令最大执行时间，默认 300 秒 - 项目级改法：直接在
composer.json顶层加"config": {"process-timeout": 1200} - 全局改法：
composer config -g process-timeout 1800 - 临时覆盖：
COMPOSER_PROCESS_TIMEOUT=1800 composer install或composer install --process-timeout=1800 - 设为
0表示禁用超时，但镜像不可用时会无限挂起，不建议生产环境使用
为什么 --timeout=600 有时没用？它管的范围很窄
这个参数常被误认为“万能 timeout”，其实它只延长 Composer 主流程的熔断阈值（依赖解析 + 下载 + 解压 + 脚本执行全过程），且优先级低于环境变量，还受 PHP 自身限制制约。
- 必须带等号：
composer install --timeout=600有效，composer install --timeout 600（无等号）完全无效 - 它不替代
--http-basic-timeout（Composer 2.2+ 才有）或http.timeout；若卡在下载阶段，光调--timeout无法解决 - 若项目含私有 Git 仓库（如
git@xxx），HTTP 超时配置对其无效，此时靠的是process-timeout - 环境变量
COMPOSER_PROCESS_TIMEOUT和COMPOSER_HTTP_TIMEOUT优先级高于所有配置文件和命令行参数（除--timeout外）
自定义脚本执行超时？那是 PHP 的事，不是 Composer 的
报错类似 Script xxx handling the xxx event returned with error code 1，并伴随 Maximum execution time of XXX seconds exceeded，说明是 PHP 进程自身超时，Composer 的任何 config 都不管用。
- Composer 的
config.timeout是 HTTP 超时，process-timeout是子进程超时，二者都不管 PHP 脚本执行 - 正确做法：用
php -d max_execution_time=0 composer run-script post-build - 若脚本由 CI/CD 触发（如 GitHub Actions），务必显式指定，避免依赖系统默认值（常为 30 或 60 秒）
- 脚本内可用
set_time_limit(0)，但必须尽早调用，且不能在disable_functions中被禁用
真正容易被忽略的点是：国内用户不配镜像源，调再大的 http.timeout 也没用；而弱网环境下，http.timeout 和 process-timeout 必须同步调高，缺一不可——前者管下载，后者管解压和脚本执行，两个环节都可能成为瓶颈。
