平台包是代表PHP版本、扩展等系统级依赖的虚拟包，用于约束依赖解析；通过config.platform指定模拟环境，确保不同环境中依赖一致性，提升项目可移植性与稳定性。
在 composer.json 中定义平台包（platform packages）主要是为了声明项目所依赖的 PHP 版本以及其他底层扩展或工具，这些不是普通的 Composer 包，而是运行环境的一部分。Composer 使用这些信息来解决依赖关系，确保安装的包与当前环境兼容。
什么是平台包？
平台包指的是代表系统级依赖的虚拟包，例如：
- php：指定 PHP 版本要求
-
ext-*：PHP 扩展，如
ext-gd、ext-pdo -
lib-*：系统库（部分支持），如
lib-pcre - api-*：PHP 扩展 API 版本（较少使用）
这些包不由 Composer 安装，但可以被用来约束依赖解析过程。
在 composer.json 中设置平台要求
通过 config.platform 字段来定义你希望模拟的平台环境。这在 CI/CD 或不同开发/生产环境之间保持依赖一致性时非常有用。
{
"require": {
"php": "^8.1",
"ext-json": "*",
"ext-pdo": "*"
},
"config": {
"platform": {
"php": "8.1.10",
"ext-gd": "7.4.3",
"ext-pdo": "8.1.10"
}
}
}
这个配置告诉 Composer：即使当前运行的 PHP 是 8.3，也应按照 PHP 8.1.10 的环境来解析依赖。这样能保证在部署到生产环境（运行 8.1）时不会引入不兼容的包。
常见用途和建议
使用平台配置可避免因开发环境过新导致安装了仅适用于新版 PHP 的组件。典型场景包括：
Android平台Overlay机制 中文WORD版
下载
本文档主要讲述的是Android平台Overlay机制；Android overlay 机制允许在不修改packages中apk的情况下，来自定义 framework和package中的资源文件，实现资源的定制。来达到显示不同的UI得目的（如MIUI）。 希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
- 团队成员使用不同 PHP 版本，统一以生产环境为准
- Docker 构建中锁定平台版本，使依赖可预测
- 防止自动启用只有高版本才有的扩展功能
你可以运行 composer config platform.php 8.1.0 来通过命令行设置，也可以直接编辑 composer.json。
查看当前平台配置
运行以下命令查看 Composer 实际使用的平台信息：
composer show -p
该命令列出所有已识别的平台包及其版本，包括 PHP、扩展和库。
基本上就这些。合理使用 config.platform 能显著提升项目的可移植性和稳定性。注意不要误将普通依赖写入平台配置。
