Composer进程超时本质是git clone等子进程卡住被强制中止，非网络下载慢；临时禁用需用--timeout=0或设环境变量COMPOSER_PROCESS_TIMEOUT=0，后者更可靠且全局生效。

Composer 安装或更新时出现 Process timed out，本质是某个子进程（比如 git clone、unzip 或脚本执行）卡住超过默认 300 秒，Composer 主动中止了它。不是网络慢导致的“下载超时”，而是本地命令执行太久被 kill —— 所以调大 timeout 或关掉超时检测，往往比换镜像更直接有效。

怎么临时禁用超时（最快速验证）

直接跳过所有进程级超时检查，适合调试或内网稳定环境：

• 运行命令时加 --timeout=0 参数，例如：composer install --timeout=0
• 或者设环境变量：COMPOSER_PROCESS_TIMEOUT=0 composer update
• 0 表示无限等待；注意这不改变 HTTP 下载超时（那是 http.timeout），只影响 proc_open 启动的命令

为什么 COMPOSER_PROCESS_TIMEOUT 比 --timeout 更可靠

--timeout 只作用于当前命令，而 COMPOSER_PROCESS_TIMEOUT 是全局生效的环境变量，覆盖所有子进程（包括插件、脚本、自定义 installer 调用的 git 或 svn）：

• 在 CI/CD 中推荐写进部署脚本开头：export COMPOSER_PROCESS_TIMEOUT=600
• Windows 用户用 set COMPOSER_PROCESS_TIMEOUT=600（cmd）或 $env:COMPOSER_PROCESS_TIMEOUT=600（PowerShell）
• 值设为 600（10 分钟）通常够用；设太高可能掩盖真实卡死问题（比如权限错误导致 git 一直等 SSH 密码）

哪些场景容易触发这个超时，但其实不该硬调高 timeout

盲目加大超时只是掩耳盗铃，下面这些情况该优先排查根本原因：

• git clone 卡住：检查是否用了 SSH 地址但没配好密钥，或公司防火墙拦截了 git:// 协议 → 改用 HTTPS 源或配 git config --global url."https://".insteadOf git://

• 

  解压大包失败：某些 Windows 环境下 7z 或 unzip 权限异常 → 用 composer config --global archive-format zip 强制走 PHP 原生解压
• post-install-cmd 脚本 hang 住：比如调用了未安装的全局命令（php-cs-fixer），或脚本里写了交互式输入 → 改成非交互模式，或加 --no-interaction

真正难处理的是混合场景：比如某私有包用 SVN + 自定义 installer，又在 post-update 中跑前端构建。这种时候 COMPOSER_PROCESS_TIMEOUT 得分段调——开发机设 600，CI 设 1200，但必须配上 composer -v 日志定位到底卡在哪一步。

# php  # 前端  # git  # composer  # windows  # 防火墙  # 环境变量  # 解压  # win  # 为什么  # format  # svn  # http  # https  # ssh  # 自定义  # 的是  # 那是  # 掩耳盗铃  # 设为  # 用了  # 写了  # 镜像  # 太高  # 太久 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 高防服务器租用首荐平台，企业级优惠套餐快速部署  高防服务器：AI智能防御DDoS攻击与数据安全保障  如何快速辨别茅台真假？关键步骤解析  高端建站三要素：定制模板、企业官网与响应式设计优化  Laravel如何发送邮件_Laravel Mailables构建与发送邮件的简明教程  canvas 画布在主流浏览器中的尺寸限制详细介绍  百度输入法ai组件怎么删除 百度输入法ai组件移除工具  购物网站制作费用多少,开办网上购物网站，需要办理哪些手续？  如何用手机制作网站和网页,手机移动端的网站能制作成中英双语的吗？  Laravel Eloquent访问器与修改器是什么_Laravel Accessors & Mutators数据处理技巧  进行网站优化必须要坚持的四大原则  如何快速使用云服务器搭建个人网站？  北京网站制作的公司有哪些,北京白云观官方网站？  如何基于云服务器快速搭建个人网站？  如何在云服务器上快速搭建个人网站？  Python自然语言搜索引擎项目教程_倒排索引查询优化案例  iOS UIView常见属性方法小结  iOS验证手机号的正则表达式  如何选择可靠的免备案建站服务器？  青岛网站建设如何选择本地服务器？  Laravel如何监控和管理失败的队列任务_Laravel失败任务处理与监控  如何在Windows 2008云服务器安全搭建网站？  如何用搬瓦工VPS快速搭建个人网站？  打造顶配客厅影院，这份100寸电视推荐名单请查收  Thinkphp 中 distinct 的用法解析  微信小程序 配置文件详细介绍  深圳防火门网站制作公司,深圳中天明防火门怎么编码？  Laravel辅助函数有哪些_Laravel Helpers常用助手函数大全  Laravel如何创建自定义中间件？（Middleware代码示例）  如何在阿里云高效完成企业建站全流程？  如何在HTML表单中获取用户输入并用JavaScript动态控制复利计算循环  Laravel路由怎么定义_Laravel核心路由系统完全入门指南  node.js报错：Cannot find module 'ejs'的解决办法  如何用JavaScript实现文本编辑器_光标和选区怎么处理  如何在 React 中条件性地遍历数组并渲染元素  如何在阿里云购买域名并搭建网站？  音响网站制作视频教程,隆霸音响官方网站？  Android使用GridView实现日历的简单功能  Windows家庭版如何开启组策略(gpedit.msc)？（安装方法）  个人摄影网站制作流程,摄影爱好者都去什么网站？  如何快速搭建虚拟主机网站？新手必看指南  教你用AI润色文章，让你的文字表达更专业  香港服务器网站卡顿？如何解决网络延迟与负载问题？  Laravel如何配置任务调度？（Cron Job示例）  javascript中闭包概念与用法深入理解  原生JS获取元素集合的子元素宽度实例  怎么用AI帮你设计一套个性化的手机App图标？  java中使用zxing批量生成二维码立牌  Claude怎样写约束型提示词_Claude约束提示词写法【教程】  如何确保西部建站助手FTP传输的安全性？