Composer不支持按命名空间自动路由,仅匹配完整包名;私有包必须在repositories中显式声明且name完全一致,依赖顺序优先级实现前缀分流,源中须真实存在对应包数据。

Composer 不支持按命名空间(如 myorg/*)自动路由到不同镜像源。 它只认包名(myorg/package-a、myorg/package-b)是否在某个 repositories 声明中显式存在,且必须逐个匹配完整包名。所谓“绑定命名空间”是常见误解,实际要靠手动声明 + 精确包名控制。
为什么 composer config --repository-url 对私有包无效
这个参数只替换元数据请求的根地址(即 packages.json),但 Composer 仍会拿着你 require 里的包名去那个地址查——如果该地址不托管 myorg/package-a(比如只是个公开镜像),就直接报 Could not find package myorg/package-a。
- 它不参与“包发现”,只改“元数据下载入口”
- 私有包必须出现在你配置的某个
repositories里,且name字段必须和require中完全一致 - 哪怕你写
"myorg/*": "https://pkgs.example.com/",Composer 也会当普通字符串忽略——JSON 不支持通配符语法
真正可行的“按前缀分流”方案:用多个 repositories + 顺序优先级
Composer 按 repositories 数组顺序查找包:遇到第一个包含该包名的源就停,不再往后查。你可以利用这点,把私有源放前面、公开镜像放后面。
- 确保私有源类型为
"type": "composer",URL 以/结尾(否则拼packages.json时 404) - 私有源必须已发布过对应包(Satis 已 build、GitHub Packages 已启用、Private Packagist 已添加该包)
- 示例结构(
composer.json):
{
"repositories": [
{
"type": "composer",
"url": "https://pkgs.myorg.com/"
},
{
"packagist.org": false
},
{
"type": "composer",
"url": "https://mirrors.tuna.tsinghua.edu.cn/composer/"
}
],
"require": {
"myorg/package-a": "^1.2",
"monolog/monolog": "^2.10"
}
}
这样 myorg/package-a 会走第一个源,monolog/monolog 因第一个源没它,跳过,第二个禁用官方源,第三个镜像源命中。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
避免踩坑:私有包名必须完全匹配,且不能依赖自动推导
很多人以为只要 require 写了 "myorg/*",Composer 就会自动找所有 myorg/xxx 包——不会。它只解析字面量包名。
-
"require": {"myorg/*": "^1.0"}是非法 JSON,直接报错 - 即使你用
composer require myorg/package-a,它也只会往composer.json里写死这一行,不会生成通配规则 - CI 环境下务必确认
auth.json放对位置:$COMPOSER_HOME/auth.json(不是项目根目录),否则私有源认证失败,表现就是“包存在但 401” - 改完
composer.json后,必须删掉vendor/和composer.lock,再跑composer install——否则 lock 文件里还存着旧 dist URL,镜像逻辑不生效
最易被忽略的一点:私有源的 packages.json 必须真实包含你要装的包名+版本。很多团队部署 Satis 后忘了运行 satis build,或者 GitHub Packages 里没打 tag,结果配置全对,却始终 Could not find package——问题不在 Composer,而在源本身没数据。










