应优先适配环境而非跳过检查；临时可加--ignore-platform-reqs，或在composer.json中设"config":{"platform-check":false}；严禁在ci/生产环境使用，且不可伪造config.platform版本。
composer install 时提示 platform-check 失败怎么办
直接跳过平台检查，用 --ignore-platform-reqs 参数。这不是“绕过问题”，而是告诉 Composer：“我清楚当前 PHP 或扩展版本不匹配 composer.json 里写的 platform 约束，但我要强制继续。”
- 只应在开发环境临时使用，CI/生产环境严禁加这个参数
- 它会忽略所有平台相关约束：PHP 版本、
ext-xxx扩展、lib-xxx库 - 如果依赖包内部硬编码调用了高版本 PHP 特性（比如
match表达式），即使装成功，运行时仍会报错
如何永久禁用 platform-check（仅限本地开发）
在项目根目录的 composer.json 中添加 "config" 块，设 "platform-check": false。注意：这不会影响全局配置，只对当前项目生效。
{
"config": {
"platform-check": false
}
}
- 比每次敲
--ignore-platform-reqs更省事，适合团队统一开发环境（如 Docker 容器内 PHP 版本固定偏低） - 它只跳过 platform 检查，不影响其他校验（如签名、哈希）
- Git 提交前务必确认该配置没被误推到主干分支——否则别人 clone 后可能因缺少扩展而运行失败
为什么不能靠修改 platform 配置来“假装兼容”
有人会改 config.platform.php 把值设成更高版本，比如把 "7.4" 改成 "8.1"，以为能骗过检查。其实这只是“伪造运行环境声明”，Composer 不会验证真假，但实际执行时照样崩。
-
config.platform是给依赖包的“编译期提示”，不是运行时兜底方案 - 若包内用了
str_contains()（PHP 8.0+），而你本地是 PHP 7.4，改了 platform 也救不了 - 这种写法容易掩盖真实环境缺陷，排查时更难定位是“装错了”还是“跑崩了”
真正安全的适配方式：用 platform-config + 本地扩展补全
与其跳过检查，不如让环境尽量贴近要求。最稳妥的是在 composer.json 的 config.platform 里明确列出你实际有的扩展和版本，比如："ext-gd": "8.1.0"。
- 这样既通过 platform-check，又避免安装那些依赖高版本扩展的包
- Docker 用户可在
Dockerfile中提前装好对应扩展，再跑composer install - Windows WSL 用户常缺
ext-pdo_pgsql，别急着加--ignore-platform-reqs，先sudo apt install php-pgsql
platform-check 的存在意义不是卡人，是防止你稀里糊涂装上根本跑不动的包。跳过它很简单，但漏掉一个扩展或版本差，后面 debug 花的时间远多于配环境。
