repositories 配置项用于自定义 Composer 包来源，支持引入私有仓库、本地包、镜像源等，常见类型包括 composer（镜像站）、vcs（Git 私有库）、package（手动定义包）和 path（本地路径），按数组顺序查找，项目级优先于全局，合理使用可增强依赖管理灵活性。
在使用 Composer 进行 PHP 项目依赖管理时，"repositories" 是一个可选但非常重要的配置项。它允许你自定义包的来源，告诉 Composer 到哪里去查找和安装依赖包。默认情况下，Composer 会从官方仓库 Packagist 获取包，但在某些场景下，你可能需要引入私有包、本地开发包，或使用镜像源，这时就需要用到 repositories 配置。
repositories 的作用
repositories 配置项用于定义额外的包源，Composer 在解析依赖时会按顺序查找这些源。它可以覆盖默认的 Packagist 行为，也可以补充私有或本地的包位置。
常见用途包括：
支持的仓库类型
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 支持的第三方库并封装它。
4. path 类型（本地文件系统路径）
用于本地开发调试，将本地目录作为依赖包链接进来。
{
"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 包。
