使用 package 类型仓库可在 composer.json 中手动定义无 Composer 支持的第三方库元信息，通过指定 name、version、source 和 autoload 实现依赖管理，适用于集成未托管到 Packagist 的项目。
当你需要使用一个没有提供 composer.json 文件的第三方库时，Composer 仍然可以通过自定义仓库类型为它创建一个“虚拟”包。这在集成一些老旧、未托管到 Packagist 或未支持 Composer 的项目时非常有用。关键在于使用 "package" 类型仓库。
什么是 "package" 类型仓库？
Composer 支持多种仓库类型，其中 package 类型允许你在 composer.json 中手动声明一个外部库的元信息（如名称、版本、自动加载方式等），而无需该库本身包含 Composer 配置。你可以把它理解为“替别人写一份 composer.json”。
如何配置 package 类型仓库
你需要在你的项目根目录下的 composer.json 文件中添加一个 repositories 字段，并定义类型为 package 的条目。
示例：引入一个 GitHub 上无 composer.json 的库
假设你想引入一个名为 some-vendor/legacy-lib 的库，它托管在 GitHub 上，但没有 Composer 支持。你希望使用它的最新稳定版本（比如 v1.2.0）。
{
"repositories": [
{
"type": "package",
"package": {
"name": "some-vendor/legacy-lib",
"version": "1.2.0",
"source": {
"url": "https://github.com/some-vendor/legacy-lib.git",
"type": "git",
"reference": "v1.2.0"
},
"autoload": {
"classmap": ["src/"]
}
}
}
],
"require": {
"some-vendor/legacy-lib": "1.2.0"
}
}关键字段说明
type: 必须是 package，表示这是一个手动定义的包。
package.name: 包的命名遵循 vendor/name 格式，必须唯一，避免与 Packagist 上已有包冲突。
package.version: 明确指定版本号。如果想支持多个版本，可以将 package 设为数组，列出多个版本对象。
package.source: 定义代码来源。支持 git、svn、hg、zip、tar 等。Composer 会据此拉取代码。
package.autoload: 手动设置自动加载规则，常见用 classmap 扫描目录，或 files 加载函数文件。若库遵循 PSR-4，也可使用 psr-4。
支持多版本的方法
如果你希望允许安装不同版本，可以把 package 写成数组：
"repositories": [
{
"type": "package",
"package": [
{
"name": "some-vendor/legacy-lib",
"version": "1.2.0",
"source": {
"url": "https://github.com/some-vendor/legacy-lib.git",
"type": "git",
"reference": "v1.2.0"
},
"autoload": { "classmap": ["src/"] }
},
{
"name": "some-vendor/legacy-lib",
"version": "1.1.0",
"source": {
"url": "https://github.com/some-vendor/legacy-lib.git",
"type": "git",
"reference": "v1.1.0"
},
"autoload": { "classmap": ["src/"] }
}
]
}
]这样你就可以在 require 中使用版本约束，如 "~1.1"。
注意事项
- 确保
name不与 Packagist 上已有的包重复，否则可能被忽略。 - 每次更改
repositories后，运行composer update使其生效。 - 建议仅用于无法通过其他方式引入的库。优先考虑 fork 后添加
composer.json并提交 PR。 - 如果源仓库结构复杂，注意调整
autoload路径，避免类找不到。
基本上就这些。通过 package 类型仓库，你可以灵活地将任何外部代码包装成 Composer 可管理的依赖，提升项目的依赖统一性。虽然配置稍显繁琐，但在整合遗留系统时非常实用。
