平台包是Composer中表示系统底层环境（如PHP版本、扩展）的虚拟包，用于确保项目依赖与运行环境匹配。通过在composer.json中声明php、ext-*等平台依赖，可强制安装环境满足条件，避免兼容性问题。使用composer show --platform可查看当前环境识别的平台包。还可通过config.platform配置模拟特定环境，保证跨环境一致性，提升项目稳定性和可移植性。
Composer 在处理平台包（platform packages）时，将其视为系统底层环境的一部分，而不是常规的 Composer 包。平台包代表的是运行 PHP 代码所依赖的基础环境，比如 PHP 本身、PHP 扩展、以及一些特殊的运行环境（如 HHVM 或特定的扩展支持）。理解这些有助于避免依赖冲突或环境不一致的问题。
什么是平台包
平台包是虚拟的“包”，用来表示当前系统提供的基础能力。常见的平台包包括：
- php：表示当前安装的 PHP 版本
- ext-json：表示是否启用了 JSON 扩展
- ext-pdo：表示 PDO 扩展是否可用
- lib-curl：表示系统中 cURL 库的版本
- composer-plugin-api：表示 Composer 插件接口版本
这些并不是通过 composer install 下载的真实包，而是由 Composer 根据当前运行环境自动检测并暴露出来的信息。
如何在 composer.json 中使用平台依赖
你可以在 require 或 require-dev 中声明对平台特性的依赖，确保项目只在满足条件的环境中安装。
{
"require": {
"php": "^8.1",
"ext-mbstring": "*",
"ext-pdo_mysql": "^1.0"
}
}
上述配置意味着：
- PHP 版本必须是 8.1 或更高
- 必须启用 mbstring 扩展
- PDO MySQL 驱动必须存在，且版本不低于 1.0
如果本地环境不满足这些条件，Composer 会报错并阻止安装或更新。
平台包的解析与冲突处理
当运行 composer install 或 composer update 时，Composer 会读取当前系统的 PHP 版本和已加载的扩展，并将它们作为平台包提供给依赖解析器。
如果某个依赖包声明了对特定平台功能的需求（例如需要 ext-redis），而你的系统没有该扩展，Composer 会在分析阶段提示错误。
你可以使用以下命令查看当前环境识别出的平台包：
composer show --platform
这会列出所有被识别的平台包及其版本，帮助你调试依赖问题。
自定义平台配置（用于跨环境兼容）
有时候开发环境和生产环境不同，你可以通过 config 中的 platform 选项来“模拟”特定平台环境，强制 Composer 按指定条件解析依赖。
{
"config": {
"platform": {
"php": "8.1.0",
"ext-gd": "8.1.0",
"ext-zip": "1.18.2"
}
}
}
这样即使你在本地使用 PHP 8.3，Composer 也会假装运行在 PHP 8.1 上，确保依赖选择与生产环境一致。
注意：设置 platform 后，Composer 将忽略实际的 PHP 版本和扩展，仅以配置为准，因此需谨慎使用。
基本上就这些。Composer 通过平台包机制把运行环境纳入依赖管理，提升了项目的可移植性和稳定性。正确配置平台依赖，能有效防止“在我机器上能跑”的问题。
