华为云镜像唯一有效地址是https://repo.huaweicloud.com/repository/php/,结尾斜杠不可少;正确配置命令为composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/,需清缓存并验证生效。

华为云镜像地址必须用 https://repo.huaweicloud.com/repository/php/
旧教程里常见的 https://mirrors.huaweicloud.com/repository/php/ 已 404,https://mirrors.huaweicloud.com 域名已停用。官方当前唯一有效地址是 https://repo.huaweicloud.com/repository/php/,结尾斜杠不能少——漏掉会因路径拼接错误返回 404,且 Composer 2.5+ 会静默失败。
正确配置命令只有一条:
composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/
注意三点:
-
repo.packagist是单数、无s,写成repos.packagist或repositories.packagist.org都无效(Composer 完全忽略,也不报错) - 必须带
-g,否则只改当前项目,全局安装仍走官方源 - URL 中的
composer是 type 参数,不能省略,否则配置静默失败
换源后依然超时?先看 composer install -vvv 卡在哪一行
超时不是“网络慢”,而是卡在某个具体环节:DNS、HTTP、子进程或 autoload。盯住最后几行输出就能定位:
- 停在
Resolving dependencies→ DNS 解析失败,跟 timeout 无关;试dig packagist.org @114.114.114.114或换 DNS - 停在
Downloading https://repo.huaweicloud.com/...→ HTTP 层卡住;该调http.timeout(Composer 2.2+ 支持),不是process-timeout - 停在
Executing command (git clone)→ 子进程超时;需设process-timeout或环境变量COMPOSER_PROCESS_TIMEOUT - 卡在
Generating autoload files后无响应 → 不是网络问题,是文件系统或 PHP 配置(如 WSL2 symlink 解析慢、APCu CLI 未启用)
全局配置生效前必须清缓存
即使镜像地址写对了,Composer 仍可能继续读取旧缓存里的 packages.json 快照,导致请求发向 packagist.org 而非华为云,表面换源实则无效。
执行以下两步才能确认真正生效:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
composer clear-cache—— 清掉本地元数据缓存 -
composer require monolog/monolog --no-install -vvv 2>&1 | grep "Downloading"—— 观察输出 URL 是否为https://repo.huaweicloud.com/...
如果仍看到 packagist.org 或 mirrors.huaweicloud.com,说明某层配置残留(项目级 repositories、环境变量 COMPOSER_REPO_PACKAGIST 或误删错字段)。
process-timeout 和 http.timeout 必须一起调
这两个参数互不替代,只改一个大概率还会超时:
-
process-timeout控制整个命令生命周期(含解压、运行脚本钩子等),默认仅 300 秒;建议设为1800:composer config -g process-timeout 1800 -
http.timeout(Composer 2.2+)控制单次 HTTP 请求(比如拉 ZIP 包),默认仅 60 秒;大包建议设为600:composer config -g http.timeout 600
CI/CD 环境中更要注意:容器每次重启都会丢失这些配置,必须在构建脚本开头显式设置,或通过 COMPOSER_PROCESS_TIMEOUT 和 COMPOSER_HTTP_TIMEOUT 环境变量固化。
最常被忽略的是缓存没清、字段名写错、URL 少斜杠,以及把 process-timeout 当成万能解药——它管不了 DNS 和 HTTP 连接本身。










