应手动下载大依赖包并放入Composer缓存目录，因Composer默认单线程HTTPS下载不支持断点续传和并发，且镜像仅加速元数据而非dist包；可查dist URL后用aria2c分卷下载拼接，再按hash命名存入cache-dir。
PHP 项目依赖包太大，composer install 卡在下载环节怎么办
直接走 Composer 默认的单线程 HTTPS 下载，遇到大包（比如 laravel/framework 带完整测试/文档的发行版、或含二进制扩展如 ext-swoole 的预编译包）极易超时、断连、重试失败。这不是你网络差，是 Composer 没做分块续传和并发控制。
用 composer config --global repo.packagist composer https://packagist.org 改镜像没用？因为大包走的是 dist URL，不是 packagist API
镜像只加速元数据（composer.json 列表），真正下载 .zip 或 .tar.gz 包时，Composer 会直连 GitHub/GitLab/源站——这些站点对国内 IP 限速严重，且不支持断点续传。
- 验证方法：运行
composer install -v，看日志里Downloading...后面的 URL 是不是https://api.github.com/或https://codeload.github.com/ - 解决方向不是换镜像，而是绕过 Composer 自动下载，手动把包下好再喂给它
- 关键配置项是
dist-url和cache-dir，不是repo
手动分卷下载 + 拼接 + 指定本地路径的实操步骤
适用于你已知具体包名和版本（比如 monolog/monolog:2.10.0），且能访问 GitHub Release 页面或 Packagist 的 dist 链接。
- 先查 dist 地址：
composer show monolog/monolog 2.10.0 -s，找到dist:行，复制url字段（通常是https://api.github.com/repos/...或https://codeload.github.com/...） - 用浏览器或
wget --spider确认该 URL 是否返回302重定向到真实 zip 地址；若重定向，用curl -I拿到最终Location:，那就是你要下的一整个 zip - 用支持断点续传的工具分卷下载（例如
aria2c -x 16 -s 16 -k 1M --file-allocation=none），或用浏览器插件切片下载多个.part文件 - 下载完后用
cat package.zip.part* > package.zip（Linux/macOS）或copy /b package.zip.part* package.zip（Windows）拼接 - 把拼好的
package.zip放进 Composer 缓存目录对应位置：~/.composer/cache/files/monolog/monolog/abc1234567890.zip（hash 可从composer show -s的dist.sha256推算，或直接删掉缓存让 Composer 报错后看它期望的文件名）
更省事的方案：改用 composer install --no-install + composer dump-autoload 组合
如果你只是想生成自动加载文件、不真跑 vendor/autoload.php，其实不需要下全量包——尤其 CI/CD 场景中只需静态分析或打包。
立即学习“PHP免费学习笔记（深入）”；
-
composer install --no-scripts --no-plugins --no-dev --no-autoloader跳过所有下载和安装逻辑 - 然后手动创建一个极简
vendor/autoload.php（内容就一行：require __DIR__.'/composer/autoload_real.php';），再跑composer dump-autoload --optimize - 这样既避开大包，又保留了类映射能力；适合部署时只读环境、Docker 构建阶段等场景
最麻烦的其实是 GitHub 的 codeload 域名被 QoS 限速后返回 403，且 Composer 不重试带 Range 头的请求——这意味着哪怕你本地有 99% 的 zip，它也不会继续下剩下的 1%，而是删掉重来。所以手动干预那一步，绕不开。
