Composer 不抓取网页,仅管理 PHP 包依赖;“抓取网页超时”实为下载包时底层 HTTP 请求超时。Composer 2.2+ 应设 http-basic-timeout(建议300~600秒),旧版用 http.timeout。

Composer 本身不抓取网页,它只管理 PHP 包依赖。你遇到的“抓取网页超时”,实际是 Composer 在下载包过程中,底层调用 cURL 或 file_get_contents 请求远程资源(如 packages.json、ZIP 包、GitHub API)时触发的网络超时 —— 和网页爬虫无关,但现象类似。
卡在 Downloading https:// 时该调 http.timeout 还是 http-basic-timeout
看 Composer 版本:
- Composer 2.2+:优先设
http-basic-timeout,它专控单次 HTTP 请求的 DNS 解析 + TLS 握手 + 首字节等待 + body 传输,单位秒,默认仅 60,国内首字节常 >1s,建议设300~600 - 旧版(http.timeout,效果等同,但参数名不同
- 注意:
process-timeout不管这个阶段——它只管git clone、unzip这类子进程,和 HTTP 下载无关
The process timed out 错误到底该改哪个 timeout
这个错误一定出现在子进程执行环节,比如:
-
git clone https://github.com/xxx/xxx.git卡在 DNS 或握手 - 解压 ZIP 包时磁盘 I/O 慢(尤其 WSL2/NTFS)
- 运行
post-install-cmd脚本(如php artisan key:generate)被交互阻塞
必须调 process-timeout,默认 300 秒,建议设为 1800(30 分钟):
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 全局生效:
composer config -g process-timeout 1800 - 临时覆盖:
COMPOSER_PROCESS_TIMEOUT=1800 composer install - 设为
0表示不限时,但不推荐——万一 Git 仓库彻底不可达,会无限挂起
为什么调了 timeout 还失败?三个关键漏点
超时问题从来不是单点参数能解决的,常见失效组合:
-
http-basic-timeout设到 600,但 PHP 的default_socket_timeout是 60 → 连接在 PHP 层就被掐断。查法:php -i | grep default_socket_timeout,需同步调高 - 换了阿里云镜像
https://mirrors.aliyun.com/composer/,但项目里硬编码了"repositories"字段,或用了"type": "git"包 → 镜像完全不生效,仍直连 GitHub,此时必须配 Git 超时或强制 HTTPS 克隆 - 中断后残留了破损 ZIP 或校验失败的缓存 →
composer clear-cache必须做,光删vendor/没用,vendor/autoload.php缺失还会导致后续命令直接报错
真正麻烦的不是“设多大超时”,而是中断后 vendor/ 和 ~/.composer/cache/ 里那些看似完整、实则 Content-Length mismatch 的文件 —— 它们不会自动清理,也不会被 --force 覆盖,只会让下一次安装在同一个地方再次失败。










