使用 package 类型仓库可让私有包配置仅对指定包生效，不影响其他依赖。通过 repositories 定义 type 为 package 的单个或多个版本包，明确 name、version 和 dist.url，确保 require 中的包名一致；支持多版本时在 package 数组中列出各版本信息；若用 VCS 可通过 vcs 类型仓库按需加载。注意避免全局影响、确保 URL 或 Git 地址可访问，并合理配置 secure-http 与清除缓存测试。
在 Composer 中，可以通过配置 repositories 字段来添加私有仓库。如果希望某个私有仓库只对特定包生效，而不是全局影响所有依赖，应该使用 package 类型的仓库，并明确指定该仓库对应的包名和版本信息。
使用 package 类型仓库限定范围
这种配置方式不会影响其他包的下载源，仅当需要安装或更新指定包时，Composer 才会从你定义的地址获取。
示例：为私有包 my-vendor/my-private-package 配置一个只对该包生效的私有仓库：
{
"repositories": [
{
"type": "package",
"package": {
"name": "my-vendor/my-private-package",
"version": "1.0.0",
"dist": {
"url": "https://assets.example.com/my-private-package-1.0.0.tgz",
"type": "tar"
},
"autoload": {
"psr-4": {
"MyPrivate\": "src/"
}
}
}
}
],
"require": {
"my-vendor/my-private-package": "^1.0.0"
}
}
说明：
- type: package 表示这是一个针对单个包的仓库定义。
- package.name 必须与 require 中一致。
- version 要匹配你需要的版本，也可以用通配符（但需注意精确性）。
- dist.url 可以是私有 URL，支持 HTTPS、SFTP 等协议，只要运行环境能访问即可。
支持多个版本的方法
如果你需要支持多个版本，可以在 package 数组中列出多个版本定义：
{
"repositories": [
{
"type": "package",
"package": [
{
"name": "my-vendor/my-private-package",
"version": "1.0.0",
"dist": {
"url": "https://assets.example.com/v1.0.0.tgz",
"type": "tar"
}
},
{
"name": "my-vendor/my-private-package",
"version": "1.1.0",
"dist": {
"url": "https://assets.example.com/v1.1.0.tgz",
"type": "tar"
}
}
]
}
]
}
结合 VCS 私有仓库的选择性应用
若你的私有包托管在 Git（如 GitHub/GitLab），也可以通过 vcs 类型仓库配合名称匹配实现“局部生效”：
{
"repositories": [
{
"type": "vcs",
"url": "git@gitlab.com:my-group/my-private-package.git"
}
],
"require": {
"my-vendor/my-private-package": "dev-main"
}
}
Composer 会优先根据包名查找可用仓库，只有涉及该包时才会尝试克隆这个 Git 仓库，因此也起到了“按需使用”的效果。
注意事项
- 不要将私有仓库设为 composer 类型并放在首位，否则会影响所有包的解析顺序。
- 确保 dist URL 或 Git 地址可被当前系统访问（如配置 SSH 密钥或 bearer token）。
- 可以结合 config 中的
secure-http控制 HTTPS 要求。 - 执行
composer clear-cache后再测试，避免缓存干扰。
