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