repositories 配置项用于自定义 Composer 包来源，支持引入私有仓库、本地包、镜像源等，常见类型包括 composer（镜像站）、vcs（Git 私有库）、package（手动定义包）和 path（本地路径），按数组顺序查找，项目级优先于全局，合理使用可增强依赖管理灵活性。
在使用 Composer 进行 PHP 项目依赖管理时，"repositories" 是一个可选但非常重要的配置项。它允许你自定义包的来源，告诉 Composer 到哪里去查找和安装依赖包。默认情况下，Composer 会从官方仓库 Packagist 获取包，但在某些场景下，你可能需要引入私有包、本地开发包，或使用镜像源，这时就需要用到 repositories 配置。
repositories 的作用
repositories 配置项用于定义额外的包源，Composer 在解析依赖时会按顺序查找这些源。它可以覆盖默认的 Packagist 行为，也可以补充私有或本地的包位置。
常见用途包括：
- 引入私有 Git 仓库中的包
- 使用国内镜像加速安装（如阿里云、华为云镜像）
- 加载本地开发中的包进行测试
- 接入企业内部的私有包仓库（如 Satis、Toran Proxy）
支持的仓库类型
Composer 支持多种类型的仓库，通过 type 字段指定。以下是常见的几种：
1. composer 类型（远程 Composer 仓库）用于指向另一个兼容 Composer 的仓库，比如镜像站或私有 Satis 服务。
示例：
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
]
}
这个配置将使用阿里云的 Composer 镜像，加快包下载速度。
2. vcs 类型（版本控制系统）支持 Git、Subversion、Mercurial 等，常用于私有 Git 仓库。
示例：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/username/private-package"
}
]
}
Composer 会克隆该仓库，并将其当作一个普通 Composer 包来处理。注意：该仓库的 composer.json 必须存在且合法。
适用于没有 VCS 的情况，手动声明某个包的详细信息。
示例：
{
"repositories": [
{
"type": "package",
"package": {
"name": "vendor/my-custom-lib",
"version": "1.0.0",
"dist": {
"url": "https://example.com/my-custom-lib-1.0.0.zip",
"type": "zip"
},
"autoload": {
"psr-4": {
"MyCustom\": "src/"
}
}
}
}
]
}
这种方式较少使用，适合临时引入一个无 Composer 支持的第三方库并封装它。
GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。
用于本地开发调试，将本地目录作为依赖包链接进来。
{
"repositories": [
{
"type": "path",
"url": "../my-local-package/"
}
]
}
支持通配符：
{
"type": "path",
"url": "../packages/*"
}
这样可以批量引入多个本地包。注意路径是相对于 composer.json 文件的。
配置作用范围与优先级
repositories 可以定义在项目的 composer.json 中，也可以在全局配置中设置（如 composer config --global repositories...）。项目级配置优先于全局配置。
Composer 查找包时，会按照 repositories 数组的顺序依次查询，直到找到匹配的包。如果你禁用了默认的 Packagist，需要显式重新启用：
{
"repositories": [
{
"type": "composer",
"url": "https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19"
},
{ "type": "vcs", "url": "https://github.com/myorg/private-repo" }
]
}
或者使用简写：
{
"repositories": {
"packagist.org": false
}
}
这会完全禁用 Packagist。如果想保留默认源并在其前添加私有源，可写为：
{
"repositories": [
{ "type": "vcs", "url": "https://private.example.com" },
{ "type": "composer", "url": "https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19" }
]
}
注意事项与最佳实践
使用 repositories 时需注意以下几点：
- 不要在公共库的
composer.json中配置私有仓库，否则其他人无法安装 - path 类型仅适用于开发环境，部署时应确保目标包已发布到正式源
- vcs 类型建议使用 SSH 或 HTTPS 并配置好凭证（如 SSH key 或 Personal Access Token）
- 频繁切换源可能导致缓存问题，可用
composer clear-cache清理
基本上就这些。合理使用 repositories 能极大提升对依赖的控制力，尤其在复杂项目或企业环境中非常实用。只要注意作用范围和安全性，就能灵活管理各种来源的 PHP 包。
