如何更新团队内部的Composer镜像配置-composer-PHP中文网

根本原因是composer全局配置只对当前用户生效，每个用户家目录下的~/.composer/config.json独立存在，git无法提交，ci/cd、宝塔、docker中用户不同导致配置不共享；项目级需在composer.json中以{"packagist.org": false}开头声明镜像源并清缓存验证。

如何更新团队内部的composer镜像配置

为什么团队里有人换源后别人不生效

根本原因是 Composer 全局配置只对当前用户生效，composer config -g 写的是 ~/.composer/config.json，每个成员的家目录不同，改完自己生效，别人完全不受影响。CI/CD 构建机、宝塔面板里的 www 用户、Docker 容器内运行的用户，也都各自有独立配置路径。

常见错误现象：
– A 同学在自己机器上跑了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，composer install 很快
– B 同学拉代码后照样卡在 Loading composer repositories
– CI 流水线报错 Could not fetch https://packagist.org/packages.json

Windows 用户配置文件实际在 C:\Users\{用户名}\AppData\Roaming\Composer\config.json，不是项目里或 Git 仓库能覆盖的位置
宝塔或 Docker 中若用 root 执行配置，但构建用的是 www 或 app 用户，必须显式切用户再配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Git 无法提交 ~/.composer/config.json，它不属于项目，也不能加进版本控制

项目级配置怎么写才不冲突

想让所有成员统一走镜像，又不想每人手动配，唯一可靠方式是把镜像声明写进项目 composer.json 的 repositories 字段——但必须禁用默认源，否则会合并请求，反而更慢。

错误写法（只加镜像，没关 packagist.org）：
"repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]
这会让 Composer 同时查 packagist.org 和镜像，网络差时直接超时。

First Principles Decomposer

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

下载

正确结构第一项必须是 {"packagist.org": false}，且放在 repositories 数组最前面

完整示例：

{
  "repositories": [
    {"packagist.org": false},
    {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
  ]
}

如果项目已有私有包源（比如内部 Nexus），别手写 JSON 合并，用命令追加：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不带 -g）
写完立刻执行 composer clear-cache，否则旧缓存的 packages.json 还在，新配置不会立刻生效

换源后 `composer update` 还看不到新版本？

不是镜像没同步，而是本地元数据缓存没刷新。Composer 默认复用 15 分钟内的 packages.json，哪怕镜像站上已更新了 monolog/monolog 到 3.6.0，你本地索引还是 3.5.0，composer update 就直接跳过网络请求。

确认是否真卡缓存：运行 ls -l $(composer config --global cache-dir)/repo/https---mirrors.aliyun.com-composer/，看 packages.json 修改时间是否 >15 分钟
Composer ≥2.5 直接用：composer update --refresh，它只清元数据缓存，不删 ZIP 包，也不重装依赖
老版本（≤2.4）只能手动删缓存目录：rm -rf $(composer config --global cache-dir)/repo/https---mirrors.aliyun.com-composer/
临时绕过缓存（调试用）：COMPOSER_CACHE_DIR=/dev/null composer update monolog/monolog

CI/CD 和 Docker 环境怎么确保镜像生效

CI 脚本里写 composer config -g 很容易失效，因为很多流水线用的是无状态容器，每次启动都是干净环境，~/.composer/config.json 不会保留。

推荐做法：在 composer install 命令前加 --repository-url 参数，例如：composer install --repository-url=https://mirrors.aliyun.com/composer/
或者设环境变量：COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install
Dockerfile 中避免用 USER 切换后再配全局镜像，优先用 --repository-url 或提前把 config.json COPY 进镜像（路径需匹配目标用户家目录）
验证是否真走镜像：加 -vvv 参数跑一次安装，搜日志里的 GET 行，域名必须是 mirrors.aliyun.com 或你指定的镜像地址