getRepositories() 方法用于获取 Composer 插件中已合并生效的仓库列表,顺序为项目>全局>默认 Packagist,返回 RepositoryManager 实例,支持动态增删查操作,适配 Composer 2.x 各类仓库类型与配置方式。

getRepositories() 方法在 Composer 插件中,主要用于动态获取当前项目已配置的仓库列表(repositories),包括 composer.json 中声明的 repositories、全局配置里的仓库,以及插件自身可能注册的仓库。
获取真实生效的仓库顺序
Composer 加载仓库时会合并项目级、全局级和插件级配置,并按优先级排序(项目 > 全局 > 默认 packagist)。调用 getRepositories() 能拿到最终合并后、实际参与包解析的仓库数组,顺序即为 Composer 查找包时的搜索顺序。这对需要“就近匹配”或“跳过某些源”的插件逻辑很关键。
- 比如做私有包代理插件,需知道哪些仓库会被优先查询,才能决定是否拦截请求
- 调试时可打印该列表,确认自定义仓库是否被正确加载或覆盖
配合 RepositoryManager 做动态操作
该方法返回的是 RepositoryRepositoryManager 实例,不只是一个数组。你可以进一步调用 addRepository()、removeRepository() 或 hasRepository() 等方法,在运行时修改仓库行为。
- 在
PluginInterface::activate()中,根据 环境变量 动态追加一个临时仓库 - 在事件监听器(如
PRE_INSTALL_CMD)中,临时禁用 Packagist 防止意外拉取公有包
避免硬 编码,提升插件兼容性
不依赖 composer.json 文件解析,而是通过 getRepositories() 获取运行时真实状态,能兼容 Composer 2.x 的仓库合并策略、v2 的 artifact 和 package 类型仓库,也适配了 composer config repositories.xxx 的命令行配置方式。
- 不用自己 parse JSON 或处理路径拼接,减少出错可能
- 插件在不同项目配置下表现一致,无需额外判断配置来源
基本上就这些。它不是用来“定义”仓库的,而是用来“读取并参与管理”已生效仓库的核心入口。用对了,插件就能更自然地融入 Composer 的依赖解析流程。