composer 的 platform 配置用于模拟指定 php 环境，确保依赖解析匹配目标环境。通过在 composer.JSon 的 config.platform 中设置 php 版本或扩展状态（如 “php”: “7.4.0”, “ext-gd”: “false”），可强制依赖分析基于设定环境进行，避免本地与生产环境差异导致的问题。支持命令行临时覆盖，如 –platform-php=7.4.33 或 –ignore-platform-req=ext-cURL，适用于多版本测试和 CI/CD 场景，提升部署可靠性。
Composer 的 platform 配置项用于覆盖系统实际的 PHP 和扩展环境信息，让 Composer 在依赖解析时“认为”运行在指定的环境中。这在开发、测试或部署时非常有用，特别是当你想模拟不同版本的 PHP 或某些扩展不存在的情况。
platform 的作用
默认情况下，Composer 会根据当前系统的 PHP 版本和已安装的扩展来决定哪些包可以安装。但通过配置 platform，你可以：
- 强制使用某个 PHP 版本进行依赖分析（即使本地版本更高）
- 假装某些扩展未安装，从而避免引入依赖这些扩展的包
- 确保项目在目标生产环境（如低版本 PHP）中也能正常安装依赖
这个配置常用于避免“本地能跑，线上报错”的问题。
如何配置 platform
可以在项目的 composer.json 中添加 config.platform 字段：
立即学习“PHP免费学习笔记（深入）”；
{ "config": { "platform": { "php": "7.4.0", "ext-gd": "false", "ext-mbstring": "true" } } }
这样 Composer 就会：
- 把 PHP 版本当作 7.4.0 来处理
- 认为 gd 扩展不存在（即使系统有）
- 认为 mbstring 扩展存在
你也可以只设置 PHP 版本：
"config": { "platform": { "php": "8.1.0" } }
如何模拟不同的 PHP 环境
除了在 composer.json 中写死，还可以通过命令行临时覆盖：
composer install –platform-php=7.4.33
这条命令会让本次安装过程“以为”运行在 PHP 7.4.33 上，影响依赖选择。
你也可以禁用某个扩展：
composer install –ignore-platform-req=ext-curl
或者忽略所有扩展检查：
composer install –ignore-platform-reqs
注意：--ignore-platform-reqs 会跳过所有平台限制，适合 CI/CD 中快速测试，但有风险。
实际应用场景
- 你在 PHP 8.2 上开发，但生产环境是 PHP 8.0 —— 用
platform.php: "8.0.0"提前发现问题 - 想确认项目是否能在没有 redis 扩展的环境下运行 —— 设置
"ext-redis": "false" - CI 流水线中测试多版本兼容性 —— 用
--platform-php参数切换
基本上就这些。合理使用 platform 配置，能让你的依赖管理更贴近真实部署环境，减少意外。