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 类型是一种“兜底”方案，适合特殊场景下手动集成外部依赖。用得好能解决问题，但不宜大规模使用。