hyperf 必须用 composer create-project hyperf/hyperf-skeleton 安装，禁用官方源、配置阿里云镜像（repo.packagist composer https://mirrors.aliyun.com/composer/）、清缓存并删 vendor/ 和 composer.lock 后重装。
想在 Linux 中用 Composer 快速下载 Hyperf，核心不是“多线程”或“改命令”，而是精准配置镜像 + 清除干扰 + 用对安装方式。Hyperf 安装慢、卡在 Resolving dependencies 或 Downloading，90% 是镜像没配对、缓存没清、或跳过了骨架初始化步骤。
必须配对的阿里云镜像（三要素缺一不可）
全局配置是最快起点，但错一个字符就静默失效：
- 键名只能是 repo.packagist（不能是 repos、mirror、Repo.Packagist）
- 中间必须显式写 composer 表示 type 值（不能省略，也不能写 vcs 或空）
- URL 必须是 HTTPS 且以 / 结尾：https://mirrors.aliyun.com/composer/ ✅，少斜杠会拼出 404 路径
执行这条命令：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/验证是否真生效：
composer config -g repo.packagist输出必须是完整 JSON：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。如果为空、null 或仍含 packagist.org，说明没写进去。
项目级配置更可靠（尤其 CI/CD 或团队协作）
在项目根目录的 composer.json 中，repositories 数组首位 写入：
"repositories": [{"packagist.org": false}, {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]注意：
- repositories 必须是数组 []，不能是对象 {}
- 禁用官方源 {"packagist.org": false} 和镜像对象并列，不能嵌套
- 改完后必须删掉 vendor/ 和 composer.lock，再运行 composer install
安装 Hyperf 必须用 create-project，别 require
Hyperf 不是普通包，骨架生成阶段的脚本决定了 DI 容器、代理类、注解扫描能否工作：
- ✅ 正确命令：composer create-project hyperf/hyperf-skeleton:3.1.25 my-app（去 GitHub Releases 查最新 patch 版）
- ❌ 错误操作：composer require hyperf/http-server——会导致类缺失、启动失败
- 别加 --no-scripts，否则关键初始化逻辑被跳过
加速下载的辅助配置（非必需但推荐）
这些能进一步减少等待时间：
- 提高并发连接数：composer config -g http-max-concurrent-downloads 10
- 加大超时限制：composer config -g http.timeout 300 和 composer config -g process-timeout 3600
- 清缓存再试：composer clear-cache（换源后这步常被跳过，导致仍卡在 DNS/TLS 阶段）
- 强制走 dist 包：composer install --prefer-dist（避免 git clone 开销）
