Composer下载源码超时怎么解决-composer-PHP中文网

卡在downloading https:// 时应调 http.timeout，该参数控制dns解析、tls握手、首字节等待及整个body传输总时间，默认300秒，弱网下易超时，需同步调高php的default_socket_timeout。

composer下载源码超时怎么解决

卡在Downloading https:// 时该调 `http.timeout`

这是 HTTP 请求阶段卡住，比如拉 packages.json、下载 ZIP 包，错误里常带 cURL error 28 或反复 retry 后失败。它不看 process-timeout，只认 http.timeout（Composer 2.x）。

http.timeout 控制 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输，单位秒，默认仅 300（5 分钟），弱网下极易触发。

项目级最稳：运行 composer config http.timeout 600，写入当前 composer.json 的 config 段，可提交、可复现
全局生效：用 composer config -g http.timeout 600，写入
```
~/.composer/config.json
```
临时覆盖优先级最高：COMPOSER_HTTP_TIMEOUT=1200 composer install，适合 CI 调试

注意：php -i | grep default_socket_timeout 查出的 PHP CLI default_socket_timeout 若低于你设的 http.timeout，会提前掐断连接——常见值是 60，务必同步调高。

`The process timed out` 错误该调 `process-timeout`

这是子进程执行太久被杀，比如 git clone、unzip、跑 post-install-cmd 脚本。错误里一定含 [RuntimeException] The process "" exceeded the timeout，加 -vvv 可看到最后那条命令。

process-timeout 控制单个外部命令最大执行时间，默认 300 秒，和 HTTP 完全无关。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

全局改：运行 composer config -g process-timeout 1800（30 分钟），写入 ~/.composer/config.json
项目级改：直接在 composer.json 顶层加 "config": {"process-timeout": 1200}
CI 环境建议用环境变量兜底：COMPOSER_PROCESS_TIMEOUT=2000，某些 Composer 版本对它更敏感
设为 0 表示不限时，但不推荐——万一远程 Git 仓库彻底不可达，会无限挂起

Git 类包下载失败，`git clone` 才是真瓶颈

Composer 遇到 "type": "git" 的包（比如开发版依赖），会调用系统 git clone，而该命令默认无超时限制，但若网络卡在 DNS 或握手阶段，会无限等待。这时 process-timeout 才真正起作用。

强制 Git 走 HTTPS（避免 SSH 认证失败）：composer config -g github-protocols https
给 Git 加超时（非必须，但更健壮）：git config --global core.sshCommand "timeout 300 ssh"（Linux/macOS）
若用代理，确保 http.proxy 和 https.proxy 已配好；公司网络不支持 CONNECT 隧道时，HTTP 代理对 HTTPS 请求无效，换镜像比配代理更可靠

换镜像源不是万能的，但它是第一优先级动作

国内推荐用 https://mirrors.aliyun.com/composer/ 或 https://mirrors.ustc.edu.cn/composer/。设阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。

注意：换源后仍可能超时——因为某些包（尤其含 git 类仓库）会绕过镜像直连 GitHub，此时必须配合 process-timeout 和 Git 代理。

验证是否生效：composer config -g repo.packagist 应输出对应 URL；若项目中硬编码了 repositories 字段，它会覆盖全局配置，得手动清理或统一改写。

真正容易被忽略的是：PHP 的 default_socket_timeout 和 Git 自身超时机制，它们不在 Composer 配置里，但会静默截断连接。调参前先 php -i | grep default_socket_timeout 和 git config --get-all core.sshCommand 看一眼。