package类型用于手动引入非标准仓库的依赖，如私有库或ZIP包，需在repositories中定义类型为"package"并指定名称、版本及dist/source源，适用于无法通过Packagist安装的场景。
在 Composer 的 repositories 配置中，package 类型用于手动定义一个外部的、不在标准仓库（如 Packagist）中的包信息。它允许你引入私有库、废弃的项目、或尚未发布到公共仓库的组件。
package 类型的基本结构
package 类型是一个对象，包含两个主要字段：type 设置为 "package"，以及 package 字段，其值是一个完整的包定义，包括名称、版本、源地址等。
示例配置：
{
"repositories": [
{
"type": "package",
"package": {
"name": "vendor/custom-lib",
"version": "1.0.0",
"dist": {
"url": "https://example.com/packages/custom-lib-1.0.0.zip",
"type": "zip"
},
"autoload": {
"psr-4": {
"CustomLib\\": "src/"
}
}
}
}
],
"require": {
"vendor/custom-lib": "1.0.0"
}
}
使用场景与说明
当你无法通过 Packagist 安装某个依赖时，可以使用 package 类型手动注入包信息。
- 引入闭源或私有项目，且不希望通过 VCS（Git）方式管理
- 集成第三方提供的 ZIP 压缩包形式的库
- 某些包已从 Packagist 移除，但你仍需使用特定版本
- 测试本地打包逻辑或模拟远程包行为
支持的源定义方式
package 可通过 dist 或 source 指定获取方式：
- dist：指向预构建的分发包（推荐用于稳定版本）
- source：指向源码地址（适合开发中版本，需支持 Git 等）
例如使用 source：
"package": {
"name": "vendor/dev-lib",
"version": "dev-feature",
"source": {
"url": "https://git.example.com/dev-lib.git",
"type": "git",
"reference": "feature-branch"
}
}
注意事项
使用 package 类型有一些限制和建议：
- 必须显式指定
version，Composer 不会自动更新 - 多个版本需要分别定义多个
package条目 - 不会检查版本冲突或更新，维护成本较高
- 若可用，优先考虑
composer类型仓库或 VCS 类型，更易于管理
基本上就这些。package 类型是一种“兜底”方案，适合特殊场景下手动集成外部依赖。用得好能解决问题，但不宜大规模使用。
