Composer 的平台包是用于校验依赖兼容性的虚拟包，代表当前 PHP 环境组件（如 php、ext-curl），不实际安装；它通过自动发现或 config.platform 手动覆盖来定义环境快照，确保开发与生产环境一致。
Composer 的平台包（platform packages）是指那些不属于项目代码、但被 Composer 当作可安装包来管理的 PHP 运行时环境组件，比如 php 本身、扩展如 ext-curl、ext-mbstring，甚至 lib-* 类库（如 lib-iconv）。它们不从 Packagist 下载，而是由当前运行环境“提供”，Composer 用它们来校验依赖兼容性。
为什么需要平台包？
PHP 项目常依赖特定 PHP 版本或扩展功能（例如 Laravel 10 要求 PHP ≥ 8.1，symfony/console 可能要求 ext-json）。Composer 在安装或更新时，会检查 composer.json 中的 require 和 config.platform，再比对当前环境实际可用的平台包版本。若不匹配，就会报错或跳过安装——这避免了在开发机上能装、上线后因环境缺失而崩溃的问题。
平台包怎么被识别和锁定？
Composer 自动发现当前环境的平台信息（通过 PHP_VERSION、extension_loaded() 等），并默认将它们注册为虚拟包：
-
php→ 对应当前 PHP 版本（如8.2.12） -
ext-curl→ 对应扩展版本（通常是0，表示存在；某些扩展如gd或openssl可能带具体版本） -
lib-iconv、lib-libxml等 → 根据系统库检测结果
你也可以在 composer.json 中用 "config": {"platform": {...}} 手动覆盖，强制指定平台版本（常用于 CI 或跨环境构建）：
立即学习“PHP免费学习笔记（深入）”；
"config": {
"platform": {
"php": "8.1.0",
"ext-gd": "0",
"ext-mbstring": "0"
}
}
常见问题和注意事项
- 扩展名必须用
ext-前缀（ext-redis✅，redis❌） - PHP 主版本号写法要准确：
"php": "8.2"表示 ≥ 8.2.0，"php": "^8.2"效果相同；但"php": "8"不会被识别为平台约束 -
config.platform是“假装环境”，不会改变真实运行时行为，只影响依赖解析结果 - 使用
composer show --platform可查看当前识别出的所有平台包及其版本
基本上就这些。平台包不是真安装的东西，而是 Composer 用来做兼容性把关的“环境快照”。用好它，能提前暴露环境差异，减少上线翻车。
