Composer高效开发：中文镜像配置保姆级教程-composer-PHP中文网

composer config -g repo.packagist 命令不生效的主因是三要素未同时满足：键名必须为 repo.packagist（单数）、type 值必须显式写 composer、url 必须 https 且末尾带 /；任一缺失即静默回退官方源，返回空或 null 且无报错。

composer高效开发：中文镜像配置保姆级教程

composer config -g repo.packagist 命令不生效？先查这三处

不是镜像挂了，是命令写错了——90% 的失效都卡在这三个硬性条件上：repo.packagist（不能多写一个 s）、composer（type 值，不是可选）、URL 必须以 https:// 开头且末尾带 /。

常见错误现象：执行完没报错，但 composer install 依然慢、日志里还是请求 packagist.org；运行 composer config -g repo.packagist 返回空或 null，说明根本没写进去。

composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ ❌ 多了个 s，静默失败
composer config -g repo.packagist https://mirrors.aliyun.com/composer/ ❌ 少 composer type，Composer 2.x 直接 fallback 到官方源
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer ❌ 少末尾 /，请求变成 /composerpackages.json → 404

宝塔/CI 环境里全局配置为啥总失效

因为 composer config -g 写的是当前用户的配置文件（比如 /root/.composer/config.json），但宝塔「一键部署」、GitHub Actions 或 Jenkins 默认用 www、runner 这类非 root 用户执行命令，压根读不到你配的文件。

验证方法：进宝塔终端，先运行 whoami，再用对应用户重配：

给 www 用户配： sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI 脚本里别依赖全局配置，改用环境变量：COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install
PHP CLI 模式下也要确认 php -i | grep 'Loaded Configuration File'，确保没被不同 php.ini 干扰

项目级配置比全局更可靠，但要注意格式

团队协作或 CI 场景下，直接往 composer.json 里写 repositories 字段，所有人拉代码后行为一致，避免本地配置不统一导致 composer.lock hash 不一致。

Composer

Composer 是 PHP 生态常用依赖管理工具，用于安装框架、组件和项目依赖。

下载

正确做法是进项目根目录，运行：

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

这条命令会自动合并，不覆盖已有私有源。但前提是原来 repositories 是对象（{}）而非数组（[]）；如果是数组，命令会报错，得先手动改成对象再执行。

千万别手写 "packagist.org": false —— 这会彻底关掉基础包校验，php、ext-json 等 required 包直接装不上
改完必须删掉 vendor 和 composer.lock，再跑 composer install，否则旧 lock 文件里的 hash 仍指向官方源
如果项目已用私有仓库，确认 repositories 字段结构是标准 JSON 对象，否则 composer validate 会失败