如何通过修改config.json进行Composer镜像源配置-composer-PHP中文网

全局镜像配置需修改config.json中repositories.packagist字段，linux/macos路径为~/.composer/config.json，windows为%appdata%\composer\config.json；必须设为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，url末尾斜杠不可省。

如何通过修改config.json进行composer镜像源配置

config.json 文件在哪，改哪个字段

Composer 的全局镜像源配置写在 config.json 里，位置取决于系统：Linux/macOS 在 ~/.composer/config.json，Windows 在 %APPDATA%\Composer\config.json。如果文件不存在，运行 composer config -g repo.packagist composer https://packagist.phpcomposer.com 会自动生成；但更推荐手动创建，避免意外覆盖已有配置。

关键字段是 repositories 下的 packagist 条目，它控制 Packagist 官方源是否启用及是否被替换。不是改 repositories 数组末尾加新源，而是必须显式重定义 packagist 这个保留键名。

镜像源 URL 填什么，为什么不能只填域名

国内常用镜像如阿里云、腾讯云、华为云都要求使用完整 HTTPS 地址，并且必须带 / 结尾（否则 Composer 会拼接错误路径导致 404）。例如：

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

url 字段值不是 https://mirrors.aliyun.com，也不是 https://mirrors.aliyun.com/composer（缺结尾斜杠），否则 composer install 时会请求类似 https://mirrors.aliyun.com/packages.json 这样的错误地址。

清华源已停止服务，https://packagist.phpcomposer.com 已失效，继续使用会导致 Could not fetch https://packagist.phpcomposer.com/packages.json
华为云镜像需登录华为云账号并开通 Composer 镜像服务，URL 形如 https://repo.huaweicloud.com/repository/php/，注意末尾斜杠
所有镜像都仅代理 Packagist 元数据和 ZIP 包，不代理 GitHub/GitLab 等 VCS 源——换源后 composer create-project 如果拉的是 GitHub 仓库，仍走原网络

全局配置 vs 项目级配置，哪个优先级高

项目根目录下的 composer.json 中定义的 repositories 会完全覆盖全局 config.json 的设置，包括 packagist 条目。也就是说，只要项目 composer.json 里有 "repositories": [...]，全局镜像就失效。

jm-jsjkxyjs02-pzl-803

查询全球任意城市的实时天气和未来天气预报

下载

常见踩坑点：

用 composer create-project laravel/laravel 新建项目后，Laravel 自带的 composer.json 包含 "repositories": {"packagist.org": false}，这会禁用所有 Packagist 源（包括镜像），导致后续 composer require 报错 No valid package could be found
解决方法：删掉项目 composer.json 里的 repositories 字段，或改为显式启用镜像："packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
想临时绕过镜像？运行 composer install --no-plugins --no-scripts 不行，必须加 --repository=https://packagist.org 才能指定源

验证镜像是否生效，怎么看实际请求地址

别只信 composer diagnose 的 “OK”，它不检测镜像是否真实可用。最直接的方式是加 -v 参数看详细日志：

composer require monolog/monolog -v

观察输出中类似这样的行：Downloading https://mirrors.aliyun.com/composer/p2/monolog/monolog.json —— 如果域名是你配的镜像站，说明生效；如果还是 packagist.org 或报 404/timeout，就要回头检查 config.json 路径、JSON 格式、URL 斜杠、以及项目级配置是否覆盖了它。

另外，Composer 1.x 和 2.x 对 config.json 的解析逻辑一致，但 2.2+ 版本开始默认启用插件隔离，某些自定义镜像插件（如 hirak/prestissimo）可能干扰源选择，遇到异常可先试 composer --no-plugins require ... 排查。