platform-overrides用于覆盖当前环境的平台包版本声明，典型用途是模拟不同PHP或扩展版本以测试兼容性，如强制指定PHP 7.4.33绕过本地PHP 8.2限制，或设ext-gd为"8.0.0"、ext-redis为false来校验依赖约束。
Composer 的 platform-overrides 主要用于**覆盖当前运行环境的平台包版本声明**，最典型用途就是模拟不同 PHP 版本（或扩展版本）来测试兼容性，而无需真实切换 PHP 环境。
强制指定 PHP 版本以绕过本地环境限制
当你在 PHP 8.2 上开发，但目标生产环境是 PHP 7.4，Composer 默认会按本地 PHP 8.2 解析依赖（比如允许安装只声明支持 ^8.0 的包），这可能导致线上报错。通过 platform-overrides 可“欺骗” Composer 使用目标 PHP 版本进行依赖解析：
{
"config": {
"platform-overrides": {
"php": "7.4.33"
}
}
}
这样即使你本地是 PHP 8.2，Composer 也会检查所有依赖是否真正兼容 PHP 7.4，并拒绝安装不兼容的版本（例如含 match 表达式或属性装饰器的包）。
模拟缺失或特定版本的扩展
某些扩展在目标服务器上可能未启用，或版本较旧（如 ext-gd 仅 8.0.0，而本地是 8.2.0）。你可以用 platform-overrides 声明一个更低/更严格的扩展版本，触发 Composer 排除依赖该扩展高版本特性的包：
立即学习“PHP免费学习笔记（深入）”；
{
"config": {
"platform-overrides": {
"php": "8.1.0",
"ext-gd": "8.0.0",
"ext-mbstring": "8.1.0"
}
}
}
- Composer 会把
ext-gd当作 8.0.0 来校验依赖约束（如"ext-gd": "^8.1"就不满足） - 对未声明的扩展（如
ext-redis），仍按实际加载情况判断；若想“假装没装”，可设为"ext-redis": false（注意：false 是有效值，表示该扩展不可用）
与 platform 的区别和协作场景
platform 是“声明我当前环境提供哪些平台包”，而 platform-overrides 是“强行覆盖这些声明”。关键差异：
-
platform无法覆盖php自身版本（Composer 会忽略），但platform-overrides可以 -
platform-overrides优先级最高，会完全取代platform和自动检测结果 - 适合 CI 流程：在 GitHub Actions 中，固定 PHP 运行时，再用
platform-overrides模拟老版本 PHP + 扩展组合做兼容性验证
注意事项和常见陷阱
- 仅影响 依赖解析和安装阶段，不影响运行时行为（代码仍由本地 PHP 执行）
- 不会自动禁用语法特性 —— 它只管 Composer 锁定版本，不负责运行时报错；你仍需在对应 PHP 环境下实际运行测试
- 值必须是字符串或布尔值：
"7.4.33"、"8.2.0"、false；不能写7.4（缺少补丁号易导致解析歧义） - 修改后需执行
composer update --lock或composer install重新生成锁文件，否则无效
