如何在云服务器ECS上极速下载PHP依赖？使用内网Compoer镜像！

阿里云ECS必须用内网镜像地址（如http://mirrors.cloud.aliyuncs.com/composer/）而非公网HTTPS地址，因内网直连延迟低于10ms、免流量计费且绕过CDN与TLS握手，实测安装耗时从2分17秒降至8.3秒；配置需满足键名repo.packagist、type为composer、URL以/结尾且用HTTP协议，否则静默失效。

阿里云ECS上必须用内网镜像地址，否则根本没提速——公网HTTPS镜像和不用镜像几乎一样慢。

为什么ECS要用内网地址而不是https://mirrors.aliyun.com/composer/

公网域名走的是外网链路，哪怕在阿里云机房里，也会绕行CDN节点、触发TLS握手、受跨地域带宽限制；而内网地址直连本地镜像服务，延迟压到10ms内，且不走流量计费。实测对比：同一台ECS上，composer install耗时从2分17秒降到8.3秒。

常见错误是复制了通用配置就直接跑，结果composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/看似成功，但实际请求仍发往公网IP。

• VPC网络用户：必须用 http://mirrors.cloud.aliyuncs.com/composer/（注意是 http，不是 HTTPS）
• 经典网络用户：用 http://mirrors.aliyuncs.com/composer/
• 别加 /packages.json 后缀，也别漏末尾斜杠 —— http://mirrors.cloud.aliyuncs.com/composer/ ✅，http://mirrors.cloud.aliyuncs.com/composer ❌

怎么确认当前走的是内网镜像

光看composer config -g repo.packagist输出没用，得看真实请求日志。

立即学习“PHP免费学习笔记（深入）”；

执行：composer show laravel/framework -vvv 2>&1 | grep -i "downloading\|mirrors\|url"

如果看到类似 Downloading http://mirrors.cloud.aliyuncs.com/composer/p2/laravel/framework.json，说明走对了；若出现 https://mirrors.aliyun.com/composer/ 或 https://repo.packagist.org/，就是没生效。

First Principles Decomposer

把任何问题拆解为根本真理，再从原子层面重建解决方案。

下载

• 项目级配置会覆盖全局设置，先运行 composer config -l | grep repositories 看是否被 composer.json 里的 "repositories" 劫持
• 检查 composer diagnose 输出里有没有 Repo packagist.org is default —— 有就代表镜像完全没加载
• 临时验证可用：composer install -r http://mirrors.cloud.aliyuncs.com/composer/ -vvv，加 -vvv 才能看到真实请求URL

配置命令与易错点

执行这条命令即可生效（VPC环境）：composer config -g repo.packagist composer http://mirrors.cloud.aliyuncs.com/composer/

注意三个硬性条件缺一不可：

• 键名必须是 repo.packagist（不是 repos.packagist，多一个 s 就静默失效）
• type 值必须显式写 composer（不能省略，否则 Composer 2.0+ 会 fallback 到官方源）
• URL 必须以 / 结尾，且协议用 http（ECS内网不强制HTTPS，用HTTPS反而可能因证书校验失败降级）

配置后立刻验证：composer config -g repo.packagist 应输出完整 URL 字符串或 JSON 对象，空、null、或仍显示 https://repo.packagist.org 都说明失败。

换源后还卡在 Resolving dependencies？那和镜像无关

内网镜像只加速“下载”阶段，不解决依赖解析慢的问题。如果你的 composer update 卡在 Resolving dependencies 超过10秒，基本可以排除镜像问题。

典型诱因：

• PHP内存不足：COMPOSER_MEMORY_LIMIT=-1 composer update
• Xdebug 开着：php -d xdebug.mode=off $(which composer) update
• config.platform.php 和实际PHP版本不匹配，比如写 "php": "8.1" 却在 8.5 上运行
• composer.lock 太旧，含已下线包，建议删掉 vendor/ 和 composer.lock 后重装

最常被忽略的一点：镜像同步有延迟，新发布的包可能1小时内还没同步到内网源。别急着关 fallback，先查 http://mirrors.cloud.aliyuncs.com/composer/ 页面底部的“最后更新时间”。