platform 配置用于指定项目运行环境的 PHP 版本和扩展，确保依赖解析符合生产环境。通过在 composer.json 的 config 中设置 platform，可声明目标环境的 PHP 版本和已启用扩展，如 "php": "7.4.3"、"ext-gd": "true"，使 Composer 忽略本地环境差异，正确选择兼容的包版本。该配置仅影响依赖解析，不验证实际环境，与运行时的 platform-check 机制不同，后者用于检查当前环境是否满足 require 的约束。常见于 CI/CD、多开发环境协作及版本迁移场景，提升依赖一致性和部署稳定性。
Composer 的 platform 配置项用于指定项目运行环境中的 PHP 版本和扩展依赖，避免在当前开发环境中安装不必要的包或触发不兼容的依赖解析。
platform 配置的作用
当你在本地开发环境使用的 PHP 版本或扩展与生产环境不一致时，Composer 可能会根据本地环境安装不符合生产要求的依赖。通过 platform 配置，你可以告诉 Composer “假装”运行在某个特定环境中，从而确保依赖解析结果符合目标部署环境。
这个配置主要影响以下方面：
- 限制 PHP 版本范围：指定项目实际支持的 PHP 版本
- 声明已安装的扩展：即使本地没启用，也可声明某些扩展存在
- 确保依赖包选择正确版本：例如某些包对不同 PHP 版本有不同实现
如何配置 platform
在 composer.json 文件中添加 config 节点下的 platform 字段：
{
"config": {
"platform": {
"php": "7.4.3",
"ext-gd": "true",
"ext-mbstring": "true"
}
}
}
以上配置表示：项目运行环境为 PHP 7.4.3，并启用了 gd 和 mbstring 扩展，即使你本地使用的是 PHP 8.1 或未开启这些扩展，Composer 也会基于这个设定解析依赖。
也可以只覆盖部分设置：
"config": {
"platform": {
"php": "8.0.0"
}
}
这样仅固定 PHP 版本，其他扩展仍以本地环境为准。
与 platform-check 的区别
注意 platform 是配置项，而 platform-check 是 Composer 运行时的一个机制，用于验证当前环境是否满足 require 中定义的 PHP 和扩展要求。两者相关但作用不同：
- platform 控制依赖解析过程
- platform-check 在执行命令时检查运行环境是否合规
比如你在 require 中写了 `"php": "^7.4"`，但当前运行的是 PHP 7.3，platform-check 会报错阻止操作。
常见使用场景
基本上就这些。合理使用 platform 配置，可以显著提升项目依赖的可预测性和部署稳定性。
