应使用 --ignore-platform-req=php 参数跳过 PHP 版本检查，既安全又不影响其他扩展校验；若需跳过所有平台依赖（含扩展），可用 --ignore-platform-reqs，但易引发运行时错误。
composer
install 报错 “Your PHP version x.x.x does not satisfy that requirement” 怎么办
这是 Composer 在解析
中的
平台约束时，发现当前 PHP 版本高于项目声明的最高兼容版本（比如项目锁死在
，而你本地是 PHP 8.2），它就直接拒绝执行安装。
这不是“忽略版本”的问题，而是 Composer 默认严格校验平台依赖。解决方向只有两个：降级 PHP（不现实），或让 Composer 跳过这层检查。
最常用且安全的做法是加
参数，只跳过 PHP 版本检查，其他扩展（如
）仍会校验
如果连扩展也想跳过，用
（注意复数 s），但容易导致运行时报扩展缺失错误
别用
硬覆盖，它会污染
或全局配置，后续协作或 CI 构建会出问题
为什么
也会卡在 PHP 版本检查
因为
本质是先下载包、再
依赖，所以同样触发平台约束校验。尤其拉取老框架（如 Laravel 6、Symfony 4）时特别明显。
直接在命令末尾追加
即可，例如：
不要提前运行
，这个配置会被写入
的
字段，下次别人 clone 项目后执行
会误以为你真在 PHP 7.4 下开发
CI/CD 流水线里慎用
，最好显式指定 PHP 运行时版本，而不是靠跳过检查来“蒙混过关”
时 PHP 版本冲突导致依赖解析失败
这种不是报错退出，而是 Composer 在尝试满足所有约束时“无解”，最终提示
—— 它连候选包列表都生成不出来。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记（深入）
”；
优先检查
里的
值，如果是硬写死的
，而你又确定代码实际兼容 PHP 8.2，就该改掉它，而不是绕过
改完后运行
预览变更，确认没有意外升级破坏兼容性的包
如果只是临时调试，
同样支持
，但它不会修改
中记录的 PHP 兼容性元信息
PHP 版本太高，但项目用了
等扩展的旧 ABI 接口
单纯跳过 PHP 版本检查还不够——有些扩展（如老版
扩展）在 PHP 8.1+ 上编译失败，或函数签名已变，这时
虽然过了，
却看不到模块，运行时直接
。
先确认扩展是否真加载：
，再查对应
是否启用了
PHP 8.0+ 推荐用
装新版（>=5.3.7），旧版
（
容器环境（Docker）里别只改
的
，还要同步更新
步骤和扩展版本号
真正麻烦的从来不是 Composer 报什么错，而是你以为跳过了，结果 runtime 才崩。PHP 版本、扩展版本、Composer 平台约束，这三者得对齐，少一个都会在某个环节咬你一口。
composer.jsonphp"php": "^7.4"--ignore-platform-req=phpext-mbstring--ignore-platform-reqsconfig platform.phpcomposer.jsoncomposer create-projectcreate-projectinstall--ignore-platform-req=phpcomposer create-project laravel/laravel myapp --ignore-platform-req=phpcomposer config platform.php 7.4.0composer.jsonconfiginstall--ignore-platform-reqscomposer updateRoot composer.json requires php ^7.4 but your php version (8.2.10) does not satisfy that requirement.composer.jsonrequire.php"^7.4"composer update --dry-runupdate--ignore-platform-req=phpcomposer.lockext-redisrediscomposer installphp -m | grep redisFatal error: Uncaught Error: Class "Redis" not foundphp -i | grep "Loaded Configuration File"php.iniextension=redispecl install redisphpredisDockerfileFROMpecl install