composer config --global 可永久修改 process-timeout、http.timeout、cache-dir、vendor-dir 等 config 字段参数;--timeout 等命令行开关无法设默认值,仅单次有效。

composer config --global 能改哪些默认参数
只有写进 config 字段的参数才能用 composer config --global 永久修改,比如 process-timeout、http.timeout、cache-dir、vendor-dir。像 --timeout 这种命令行开关本身不能“设默认值”,它只对单次执行有效。
常见可全局覆盖的键包括:
-
process-timeout:控制git clone、unzip等子进程超时 -
http.timeout:控制单次 HTTP 请求总耗时(DNS + TLS + 传输) -
http-basic-timeout:Composer 2.2+ 新增,更细粒度管 HTTP 下载阶段 -
github-oauth.github.com:凭据类配置,必须全局设,项目级无效 -
repos.xxx:自定义仓库,必须分步设置,不能传 JSON 字符串
为什么直接改 ~/.composer/config.json 很危险
手改 ~/.composer/config.json(Linux/macOS)或 %APPDATA%\Composer\config.json(Windows)极易出错——少个逗号、引号没闭合、键名拼错,都会导致后续所有 composer 命令静默失败,报错却指向完全无关的位置,比如提示 Could not find package,实际是 JSON 解析失败。
composer config --global 会自动校验键名合法性、JSON 结构、路径拼接,并拒绝非法输入,这才是唯一安全的入口。
容易踩的坑:
- 漏掉
--global或-g,结果写进了当前项目的composer.json,造成 vendor 安装异常 - 值含空格不加英文双引号,如
composer config --global cache-dir /data/composer cache→ 实际只设了/data/composer - 试图一次性设置嵌套键:
composer config --global repos.myrepo '{"type":"composer"}'→ Composer 直接拒绝,必须拆成两条命令
--timeout=600 和 http.timeout 有什么区别
--timeout=600 是命令行参数,只对当前命令生效,且必须带等号;它延长的是 Composer 主流程熔断阈值(依赖解析 + 下载 + 解压 + 执行脚本),默认 300 秒。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
http.timeout 是配置项,写入全局 config.json 后永久生效,控制的是底层 cURL 的单次请求总耗时,默认约 60 秒,弱网下极易触发 curl error 28。
两者不互替:
- 卡在
Downloading https://...阶段?优先调高http.timeout或http-basic-timeout - 卡在
Cloning git@xxx或解压大 ZIP 包?那是process-timeout在起作用 -
--timeout设再高,也救不了被http.timeout中断的下载请求
环境变量比配置文件优先级更高
COMPOSER_PROCESS_TIMEOUT 和 COMPOSER_HTTP_TIMEOUT 这两个环境变量,优先级高于 composer.json 和 config --global 设置,甚至高于大部分命令行参数(--timeout 除外)。
例如:
COMPOSER_PROCESS_TIMEOUT=0 composer install
会让 process-timeout 配置彻底失效,进程可能无限挂起——这在 CI 容器里尤其危险,因为外层 timeout 600 composer install 可能被内部挂起绕过。
真正要改默认行为,优先走 composer config --global;临时调试或容器部署,才用环境变量,但务必确认没被 disable_functions 或 socket 超时限制反向截断。

















