答案:因为 Composer 官方配置 schema 仅支持 process-timeout 字段,timeout 和 http-timeout 不在合法字段列表中,解析时被静默忽略;HTTP 层超时需通过 composer config http.timeout 或命令行 --http-timeout 设置。

composer.json 里只能写 process-timeout,其他如 timeout、http-timeout、http.timeout 全部无效,Composer 会静默忽略。
为什么 timeout 和 http-timeout 在 composer.json 里不起作用
Composer 的配置系统明确区分了不同层级的超时控制:process-timeout 是唯一被 composer.json 的 config 节点支持的超时字段;而 HTTP 层超时(比如下载 packages.json 或 ZIP 包)不由 JSON 配置驱动,它只响应命令行参数或全局 config 文件里的 http.timeout。
常见错误现象:
- 在
composer.json里写了"timeout": 600,运行composer update依然 5 分钟就报cURL error 28 - 写了
"http-timeout": 1200,但composer config --list根本不显示该字段,验证失败
根本原因:这些字段名不在 Composer 官方 schema 中,解析时直接跳过,不会报错也不会警告。
process-timeout 在 composer.json 中的正确写法
这个值控制的是子进程执行时间(如 git clone、unzip、post-install 脚本),不是网络请求。它必须是整数,不能加引号,且必须放在顶层 config 对象下。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
示例(正确):
{
"config": {
"process-timeout": 1800
}
}
关键要点:
-
"process-timeout": 1800✅ 整数,无引号,位置在config下 -
"process-timeout": "1800"❌ 字符串会被当 0 处理,等效于立即超时 -
"timeout": 1800❌ 字段名错误,完全不生效 - 改完后建议运行
composer dump-autoload -o,避免 autoload 错误掩盖真实超时问题
HTTP 超时不能靠 composer.json?那该怎么配
如果你卡在 Downloading https://...,说明是网络传输阶段超时,process-timeout 完全不管用。此时必须用以下方式之一:
- 全局设置(推荐):
composer config -g http.timeout 1200,写入~/.config/composer/config.json(新版)或~/.composer/config.json(旧版) - 项目级临时写入:
composer config http.timeout 1200,会写进当前composer.json的config段 —— 注意:这是 Composer 2.x+ 特性,且仅限http.timeout,不是timeout - 单次覆盖:
composer update --http-timeout=1200(注意是双横线 +http-timeout,不是--timeout)
别忘了同步检查 PHP 的 default_socket_timeout:运行 php -i | grep default_socket_timeout,如果输出是 60,那即使你设了 http.timeout 1200,底层 socket 也会在 60 秒强制断开。
真正容易被忽略的是:一个超时配置解决不了所有问题。process-timeout 和 http.timeout 控制的是两个完全不同的阶段,国内用户还常因镜像源没切对、代理漏配 https-proxy 或 DNS 缓存失效导致“看起来像超时”,实际是连接根本没发出去。

















