加了私有仓库后require公共包失败,是因为Composer显式声明repositories会自动禁用隐式packagist.org源;必须在repositories数组末尾显式添加{"type":"composer","url":"https://packagist.org"}并确保type字段完整,否则monolog/monolog等通用包将报Could not find package。

能共存,但必须显式声明 packagist.org 且放数组末尾;否则公共包(如 monolog/monolog)会直接报 Could not find package。
为什么加了私有仓库后 composer require monolog/monolog 就失败?
因为你手动写了 repositories 数组,Composer 就自动禁用了隐式的 packagist.org——它不会“智能补全”,也不会 fallback。现象就是:私有包能装,通用包全 404。
- 必须把
{"type": "composer", "url": "https://packagist.org"}显式加进repositories数组 - 这个条目要放在私有源之后(比如私有 Composer 源或 VCS 源的后面),否则私有源若没声明
monolog/monolog,Composer 就停在那儿不往下查 - 不能只写 URL,
type字段缺一不可;写成{"url": "https://packagist.org"}是无效的
vcs 类型私有仓库和 composer 类型公共源怎么配才不冲突?
vcs 和 composer 是两类完全不同的行为模式:前者只响应明确 require 的包名(且 name 必须完全匹配),后者提供全局包索引。它们可以并存,但不能互相替代。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
vcs条目只对require中出现的、且其composer.json里"name"字段完全一致的包生效(例如"name": "acme/utils",就不能靠vcs装acme/*) - 多个
vcs源之间按数组顺序取第一个匹配的,后面的同名包被忽略 -
vcs源无法提供monolog/monolog这类通用包,所以仍需packagist.org或镜像源兜底 - 如果私有包也托管在 Satis 或 Private Packagist 上,优先用
type: composer,性能和稳定性远高于vcs
如何让私有包走内网源、公共包走镜像,且不互相干扰?
关键不是“多源叠加”,而是控制元数据来源顺序 + 禁用默认行为。最稳的组合是:packagist.org 关掉,私有源置顶,镜像源垫底。
- 在
repositories开头加私有composer源(如https://pkg.internal.company),确保它包含所有内部包的完整packages.json - 中间可选加
vcs源(仅用于临时开发未发布到私有源的包) - 结尾必须加镜像源,并显式关闭默认源:
{"packagist.org": false}放在repositories外层(同级) - 示例结构:
{
"repositories": [
{"type": "composer", "url": "https://pkg.internal.company"},
{"type": "vcs", "url": "git@github.com:internal/temp-tool.git"},
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
],
"packagist.org": false,
"require": {
"internal/tool": "^2.1",
"monolog/monolog": "^3.0"
}
}
注意:packagist.org: false 这一行不能漏,否则 Composer 仍会尝试连原站。
最容易被忽略的是 composer.lock 文件里的源记录——换源后不删 lock 文件,Composer 仍会按旧地址拉包。遇到诡异的 404 或版本错乱,先 rm composer.lock vendor 再 composer install。

















