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": "8.2" 表示 ≥ 8.2.0，"php": "^8.2" 效果相同；但 "php": "8" 不会被识别为平台约束config.platform 是“假装环境”，不会改变真实运行时行为，只影响依赖解析结果composer show --platform 可查看当前识别出的所有平台包及其版本基本上就这些。平台包不是真安装的东西，而是 Composer 用来做兼容性把关的“环境快照”。用好它，能提前暴露环境差异，减少上线翻车。
以上就是什么是Composer的平台包（platform packages）？（php/ext版本锁定）的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
661
收藏
