platform配置通过在composer.json中声明生产环境的PHP版本和扩展，使Composer在解析依赖时以此为依据，确保本地安装的包与生产环境兼容，避免因环境差异导致部署失败。
Composer 的 platform 配置项允许你在本地开发环境中“模拟”生产服务器的 PHP 及扩展环境，从而避免因环境差异导致的依赖安装问题。它并不会真正改变你的运行环境，而是告诉 Composer：在解析依赖时，假装当前系统具有指定的 PHP 版本和已安装的扩展。
platform 是如何工作的
当你运行 composer install 或 composer update 时，Composer 会检查项目依赖的最低 PHP 版本和所需扩展（如 ext-pdo、ext-curl 等）。默认情况下，它使用你当前机器上实际的 PHP 版本和已加载的扩展来判断能否满足这些依赖。
通过在 composer.json 中配置 config.platform，你可以覆盖这一行为：
{
"config": {
"platform": {
"php": "8.1.0",
"ext-gd": "3.0",
"ext-mbstring": "1.0"
}
}
}
设置了之后，即使你本地是 PHP 8.3，Composer 也会按 PHP 8.1 的能力去选择兼容的包版本；即使你没装 gd 扩展，Composer 也认为它存在，不会因此拒绝安装依赖 gd 的包。
为什么需要模拟生产环境
常见的问题是：你在本地用高版本 PHP 开发，但生产环境是较低版本，或者某些扩展未开启。如果不做平台配置，可能会出现以下情况：
- 本地安装了只支持 PHP 8.2+ 的包，但生产环境是 PHP 8.1，部署时报错
- 本地有 ext-redis，而生产没有，导致运行时报 Class Redis not found
- CI/CD 构建时使用的是基础 Docker 镜像，缺少扩展，但依赖却通过了
通过设置 platform 为生产环境的实际配置，Composer 能提前发现不兼容问题，确保生成的 composer.lock 文件在生产部署时能正确安装。
实际使用建议
为了更真实地反映生产环境，推荐做法包括：
- 将 config.platform 设置为生产服务器的 PHP 主版本和关键扩展版本
- 不要设置本地不存在的扩展版本过高，否则可能误导依赖判断
- 可在 CI 环境中额外强化 platform 限制，防止意外升级
- 配合 platform-check 功能（Composer 2.2+），在运行时验证扩展是否真的存在
例如，如果你的线上环境是 PHP 8.1 + ext-apcu，就在 composer.json 中明确声明：
"config": {
"platform": {
"php": "8.1.0",
"ext-apcu": "5.1.20"
}
}
这样即使你本地没开 APCu，Composer 也不会跳过依赖它的包，同时能确保选的版本与 PHP 8.1 兼容。
基本上就这些。platform 不是魔法，但它是一个简单有效的契约机制，让依赖管理更贴近真实部署场景。合理使用，可以大幅减少“在我机器上能跑”的问题。
