Composer PHP自定义仓库源配置_Composer切换镜像指南【优化】-composer-PHP中文网

全局配置 composer config -g repo.packagist 不生效，因键名必须严格为 repo.packagist（单数、小写、带 repo. 前缀），且需同时指定 type 和 url；composer ≥2.2 应改用 repositories.packagist.org。

composer php自定义仓库源配置_composer切换镜像指南【优化】

全局配置 composer config -g repo.packagist 不生效，大概率不是网络问题，而是键名、type 或 URL 三者中至少漏了一个——它不会报错，只会静默失效。

为什么 `composer config -g repo.packagist` 总是空或 null

Composer 内部硬编码只识别 repo.packagist（单数、小写、无 s），写成 repos.packagist、packagist.org 或 Repo.Packagist 都会存进无效字段。命令看似执行成功，但 composer config -g repo.packagist 查出来就是空或 null。

composer config -g repo.packagist 输出为空 → 键名写错
输出 {"url": "https://packagist.org"} → 没覆盖成功，可能被项目级配置屏蔽
输出 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} → 正确写入

`composer config -g` 命令必须带齐的三个参数

这条命令不是“两段式”，而是严格三元组：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，缺一不可。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

-g：指定全局作用域；不加就只改当前目录下的 composer.json
repo.packagist：唯一合法 key，大小写敏感，不能多 s，不能少 repo. 前缀
composer：type 值，不是注释也不是可选项；省略后 Composer 2.0+ 会 fallback 到默认源
https://mirrors.aliyun.com/composer/：URL 必须 HTTPS 开头，且末尾必须有 /；否则拼出 .../composerpackages.json 导致 404

Composer ≥2.2 应该用 `repositories.packagist.org`

新版（查版本：composer --version）已转向 repositories.packagist.org，继续用 repo.packagist 可能被静默忽略，尤其在 CI 环境或 Docker 镜像里。

设阿里云：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'
设腾讯云（fallback 更友好）：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}'
恢复默认：composer config -g --unset repositories.packagist.org
注意 value 必须是合法 JSON 字符串（单引号包裹整个值，内部双引号保留）

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

进项目根目录运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g），它会安全合并进 composer.json 的 repositories 字段，但前提是原 repositories 是对象（如 "repositories": {}），不是数组。

如果 composer.json 里已有 "repositories": [] 或 "repositories": {"packagist.org": false}，全局配置完全失效
数组格式会直接报错，需先手动改成对象再执行命令
提交 Git 后，队友 git pull && composer install 自动走镜像，composer.lock hash 一致
某些模板（如 Laravel 脚手架）自带禁用 packagist 的配置，得先删掉或重置：composer config --unset repositories

换源后一定要 composer clear-cache，否则本地缓存的 packages.json 元数据仍指向旧地址；验证时别只看命令回显，要盯 composer diagnose 的 “Repo:” 行，以及 composer update -vvv 日志里 Downloading 的实际 URL —— 那才是真实请求路径。