应使用--ignore-platform-req=php精准跳过PHP版本校验，只绕过版本检查而保留扩展等其他平台约束；若省略等号和值（即--ignore-platform-req），Composer会将其视为--ignore-platform-reqs，导致PHP版本、扩展、系统库等全部检查被跳过，引发运行时崩溃风险。
直接加 --ignore-platform-req=php，这是最安全、最常用的做法。它只跳过 PHP 版本校验，不碰扩展、库、架构等其他平台项——既绕开报错，又保留对真实运行环境的约束。
为什么不能只写 --ignore-platform-req
这个参数**必须带等号和值**，否则会被 Composer 当作 --ignore-platform-reqs 处理（即全量忽略）。比如：
-
composer install --ignore-platform-req=php✅ 只跳过 PHP 版本 -
composer install --ignore-platform-req❌ 等价于--ignore-platform-reqs，连ext-gd、lib-curl都不检查了
很多团队踩坑就在这儿：本地跑通了，上线一执行就报 Class 'Redis' not found 或 Undefined function str_contains()——因为扩展缺失或函数不存在，而你根本没意识到。
composer install 和 composer update 的风险差异
两者对平台检查的敏感度不同，处理方式也得区分：
立即学习“PHP免费学习笔记（深入）”；
-
composer install默认按composer.lock还原，只要锁文件当初能装上，通常不会因 PHP 版本报错；若报了，大概率是锁文件里某包的require.php比你本地高，此时--ignore-platform-req=php是合理选择 -
composer update会重新解析整棵树，平台检查更激进；绝对不要用--ignore-platform-reqs配合update——它可能把 PHP 8.2+ 才支持的包写进 lock 文件，导致部署后直接 fatal error - CI/CD 中如需
update，优先在目标环境（如 PHP 8.2 容器）里执行；若必须本地跑，用composer update --ignore-platform-req=php，并确保ext-*全部就位
永久配置 vs 临时命令行参数
想长期“假装”某个 PHP 版本？别改全局配置，改项目级 composer.json：
{
"config": {
"platform": {
"php": "8.2.0"
}
}
}
这比命令行参数更可复现，适合 CI 脚本和团队协作。但注意两点：
- 它影响
install和update全流程，且所有require-dev包也会按这个版本解析 - 它只是“骗过依赖解析”，不解决运行时兼容性——比如你设成
"php": "8.2.0"，但代码用了enum，而本地是 PHP 8.1，照样运行失败
真正难处理的从来不是怎么跳过检查，而是跳过后哪段代码会触发不兼容语法或行为变化。PHP 8.0 的 match、8.1 的 never、8.2 的只读类……这些都不会在 composer install 阶段暴露，而是在 require 或第一次调用时才崩。
