Composer如何配置repositories优先加载顺序

Composer仓库优先级由配置顺序决定，先列出的仓库优先查找，支持按包过滤、禁用默认源及本地路径仓库，实现灵活的包加载控制。

1. repositories 的优先级由配置顺序决定

在 composer.json 中，先声明的仓库具有更高的优先级。Composer 会按你在 repositories 数组中定义的顺序去拉取包的元数据（如版本、依赖等），因此你可以通过调整顺序控制从哪个源优先安装包。

例如：

"repositories": [
    {
        "type": "composer",
        "url": "https://packagist.company.com"
    },
    {
        "type": "composer",
        "url": "https://packagist.org"
    }
]

上面配置表示：先尝试从公司私有镜像获取包，如果找不到，再回退到官方 Packagist。

2. 使用 composer.json 控制特定包走指定仓库

如果你只想让某些包从私有仓库加载，其他仍走默认源，可以设置 repositories 为 按包过滤的模式：

"repositories": [
    {
        "type": "composer",
        "url": "https://packagist.company.com",
        "only": ["vendor/private-package", "myorg/*"]
    },
    {
        "type": "composer",
        "url": "https://packagist.org"
    }
]

这样，只有匹配 only 列表的包会从私有源查找，其余仍然使用官方源，避免冲突或重复下载。

3. 禁用默认源以强制使用私有仓库

如果你想完全使用私有仓库，防止意外从公共源下载包（比如保障安全或合规），可以显式禁用 Packagist 默认源：

Synthesys

Synthesys是一家领先的AI虚拟媒体平台，用户只需点击几下鼠标就可以制作专业的AI画外音和AI视频

下载

"repositories": [
    {
        "type": "composer",
        "url": "https://packagist.company.com"
    },
    {
        "packagist.org": false
    }
]

这会关闭全局的 packagist.org 源，所有包都必须能在你的私有源中找到。

4. 项目本地仓库和路径仓库的使用场景

你也可以添加本地路径类型的仓库用于开发调试：

"repositories": [
    {
        "type": "path",
        "url": "./packages/my-private-lib"
    },
    {
        "type": "composer",
        "url": "https://packagist.company.com"
    }
]

这种情况下，Composer 会优先尝试从本地目录软链（symlink）或复制文件方式加载包，适合内部库协同开发。注意：路径仓库默认不会自动优先覆盖远程，除非它出现在前面且能解析到所需版本。

小提示：使用 composer show -a vendor/package 可查看某个包的所有可用版本及其来源仓库；用 composer install -v 查看详细请求日志，确认是从哪个源下载的。