metapackage是一种无实际代码、仅用于聚合依赖的Composer包类型。它通过设置"type": "metapackage"并定义require列表，使用户能一键安装多个相关包，如执行composer require my-company/php-stack即可自动安装Guzzle、Monolog和Symfony Console等组件，适用于统一技术栈场景。与普通包不同，metapackage不包含autoload、bin或源文件，仅作为依赖管理的“空壳”，其版本更新主要调整所依赖子包的版本。

metapackage 是 Composer 中的一种 package-type，它的主要作用是聚合其他依赖包，本身不包含实际的功能代码。

什么是 metapackage？

metapackage 指的是一个只有 require 列表、没有实际源代码的 Composer 包。它存在的目的不是提供功能，而是为了方便一次性安装一组相关的包。

例如，你正在开发一套 PHP 应用框架，可能需要同时引入路由、数据库、日志等多个组件。通过创建一个 metapackage，用户只需安装这个 metapackage，就能自动把所有必要的组件都装上。

metapackage 的典型特征

• type 字段设置为 metapackage
• composer.json 中通常只定义 require，不包含 autoload、bin 等实际功能配置
• 包内一般没有 PHP 源文件，或仅有极简的占位文件
• 版本更新时，主要是调整所依赖的子包版本

使用场景举例

比如 Laravel 的 laravel/laravel 项目骨架并不是 metapackage，但某些工具集合会用到这种类型。假设你发布一个叫 my-company/php-stack 的包：

{
  "name": "my-company/php-stack",
  "type": "metapackage",
  "require": {
    "guzzlehttp/guzzle": "^7.0",
    "monolog/monolog": "^2.0",
    "symfony/console": "^5.0"
  }
}

这样，团队成员只需要执行：

就能一键安装常用工具，统一技术栈。

和普通包的区别

普通包会提供可复用的类库或命令行工具，而 metapackage 只是一个“空壳”，它的价值在于依赖关系的组织。Composer 安装时会正常解析其 require 并下载对应包，但不会尝试加载它的代码。

基本上就这些 —— metapackage 就是个“打包套餐”用的标签，帮你简化依赖管理。