阿里云服务器ECS部署PHP如何快速配置Compoer镜像？

阿里云ECS必须使用内网镜像地址（如http://mirrors.cloud.aliyuncs.com/composer/）才能提速，公网镜像与不用镜像几乎一样慢；需确认真内网环境、严格按三要素配置命令、注意执行用户权限及项目级配置覆盖问题。

阿里云ECS必须用内网镜像地址，否则根本没提速

公网镜像（如 https://mirrors.aliyun.com/composer/）在ECS上和不用镜像几乎一样慢——它仍走公网链路，绕CDN、耗TLS握手、受跨地域带宽限制。真正生效的只有内网地址：http://mirrors.cloud.aliyuncs.com/composer/（VPC网络）或 http://mirrors.aliyuncs.com/composer/（经典网络）。二者都必须用 http 协议，不是 https；末尾斜杠 / 不可省略；域名不能手误写成 aliyun.com。

执行命令前先确认是否真在内网环境

别信“没开EIP就一定走内网”。绑了弹性公网IP（EIP）、开了NAT网关、甚至部分新购ECS默认配置，都会导致请求走公网。验证方法：

• 运行 curl -s https://ip.cn，返回IP必须是内网段（10.0.x.x、172.16.x.x 或 192.168.x.x），且不显示公网出口IP
• 运行 nslookup mirrors.cloud.aliyuncs.com，A记录应为内网IP（如 100.100.2.136），CNAME 应含 aliyuncs.com
• 运行 curl -I http://mirrors.cloud.aliyuncs.com/composer/，返回状态码应为 200 或 403（403说明能连通但权限受限，仍是内网）；若超时或返回 https:// 域名，则不在内网

配置命令三要素缺一不可

这条命令只对VPC环境有效：composer config -g repo.packagist composer http://mirrors.cloud.aliyuncs.com/composer/。注意三个硬性条件：

• 键名必须是 repo.packagist（少个 o 或多加 s 都静默失效）
• type 值必须显式写成 composer（不能省略，也不能写成 vcs 或空字符串）
• URL 必须以 http:// 开头，结尾带 /，且不能加 /packages.json 后缀

执行后立刻验证：composer config -g repo.packagist 输出必须是完整 JSON，形如 {"type": "composer", "url": "http://mirrors.cloud.aliyuncs.com/composer/"}。如果输出为空或含 https://，说明没写对。

First Principles Decomposer

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

下载

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

宝塔、systemd、CI等场景下配置常被忽略的执行用户

你在SSH里用root执行了 composer config -g，但宝塔PHP管理器、systemd服务、Jenkins任务实际是以 www 或 jenkins 用户运行的，它们读不到root的 ~/.composer/config.json。解决方式：

• 宝塔或systemd：改用 sudo -u www composer config -g repo.packagist composer http://mirrors.cloud.aliyuncs.com/composer/
• CI脚本：别依赖全局配置，改用临时参数，如 composer install -vvv --repository-url=http://mirrors.cloud.aliyuncs.com/composer/
• 项目级覆盖：如果 composer.json 里有 "repositories" 字段，全局设置完全无效；此时要么删掉该字段，要么手动编辑 composer.json，把内网镜像作为 "packagist" 子项加入，并确保根节点有 "packagist.org": false

最易被忽略的是：已有 composer.lock 的项目，首次切内网镜像大概率报 hash 不匹配——旧 lock 文件里记录的是官方源的 dist URL，和内网镜像路径不一致。删掉 vendor/ 和 composer.lock 再重装，才是干净验证。