怎样使用配置文件指定Composer镜像配置-composer-PHP中文网

因为项目级 repositories 字段会无条件覆盖全局镜像配置，且依赖包自身的 repositories 声明被 composer 完全忽略；必须确保项目根目录 composer.json 中无 repositories 字段（或为空对象），并配合 clear-cache、删 vendor/ 和 composer.lock 后重装。

怎样使用配置文件指定composer镜像配置

composer.json 里写 repositories 为什么不管用？

因为 Composer 只读取根项目（你执行 composer install 所在目录）的 composer.json，而依赖包自己声明的 repositories 字段会被完全忽略——这不是配置错误，是设计如此。你在某个依赖的 composer.json 里加了镜像源，Composer 压根不看。

更关键的是：如果你在自己的项目 composer.json 里手动写了 "repositories" 字段（比如 {"packagist.org": false} 或空数组），它会直接覆盖全局镜像配置，导致 repo.packagist 设置彻底失效。

常见错误现象：composer config -g repo.packagist 显示正确，但 composer install 日志里仍出现 packagist.org
检查方法：打开项目根目录下的 composer.json，搜索 "repositories" 字段是否存在
临时验证：运行 composer config --unset repositories 清掉项目级干扰项，再试

~/.composer/config.json 是怎么被读取的？

全局镜像配置实际写入的是用户家目录下的 ~/.composer/config.json（Windows 是 %APPDATA%\Composer\config.json），Composer 启动时自动加载，优先级高于默认值，但低于项目级 composer.json 中的 repositories。

这个文件只对“调用它的 PHP 解释器”生效。比如群晖 NAS 上 WebStation 用的是 /volume1/@appstore/PHP82/usr/bin/php，那你必须用这个路径执行 composer config -g，否则配置写进去了也白搭。

验证是否真写进去了：composer config -g repo.packagist 输出必须是完整 JSON，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果输出为空或报错，说明没写成功；可能原因包括：拼错键名（repos.packagist 多了个 s）、权限不足、用了 sudo 导致写进 root 用户配置
Windows 下 CMD 对引号敏感，命令中不要加引号，直接粘贴执行

项目级配置怎么安全写入 composer.json？

项目级配置不是手改 composer.json，而是用 composer config 命令追加，避免 JSON 格式错误或破坏已有结构。

Composer

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

下载

它会把镜像声明安全地塞进 repositories 字段下，前提是该字段当前是对象（{}），不是数组（[]）。如果是数组，命令会直接报错，得先手动改成空对象。

命令是：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意没有 -g）
它只添加 "packagist" 子项，不会覆盖已有的私有源（比如 type=package 的条目）
切忌手写 "packagist.org": false —— 这会关掉所有回退机制，镜像挂了就直接失败
CI/CD、Docker、宝塔等多用户环境，项目级配置比全局更可靠，因为它可提交 Git，所有环境行为一致