应优先检查并修正 composer.json 中的 config.platform 配置或本地环境，而非直接使用 --ignore-platform-reqs；该参数仅跳过校验，不解决实际兼容性问题，可能导致运行时错误。
composer install 时提示 platform requirements 不满足怎么办
直接加 --ignore-platform-req 或 --ignore-platform-reqs 就能跳过检测，但得清楚后果——这不是修复问题，是绕过校验。常见于本地 PHP 版本低于 composer.json 中 config.platform.php 声明的版本，或扩展（如 ext-gd）未启用时。
-
--ignore-platform-req=ext-gd：只忽略某一项（支持多次使用） -
--ignore-platform-reqs：忽略全部平台要求（含 PHP 版本、所有扩展） - 该参数仅影响当前命令，不修改
composer.json或锁文件 - CI/CD 环境慎用，可能掩盖环境不一致问题
为什么 config.platform 会触发检测失败
config.platform 是人为锁定依赖解析时“假装”的运行环境，Composer 用它模拟低版本 PHP 或缺失扩展，确保装出来的包能在目标环境跑。但如果你本地开发环境实际满足要求，只是配置写死了旧版本，就会误报。
- 检查
composer.json里是否有类似"config": {"platform": {"php": "7.4.0", "ext-gd": "0"}} - 删掉整个
config.platform段是最干净的解法（除非真要兼容老环境） - 若必须保留，用
--ignore-platform-req=php跳过 PHP 版本校验即可 - 注意：修改
config.platform后需重新composer update才会重算依赖树
--ignore-platform-reqs 和 platform-check 的关系
从 Composer 2.2 开始，默认开启 platform-check，它会在 install 和 update 时主动校验当前环境是否匹配 config.platform 或 require 中声明的 PHP/扩展要求。而 --ignore-platform-reqs 是唯一能关掉这次校验的开关。
- 不是所有命令都受控：比如
composer dump-autoload不走平台检查 -
composer create-project也支持该参数，常用于快速拉起 demo 项目 - 如果用了
--no-platform-check（旧版参数），现在会警告并自动转为--ignore-platform-reqs - 错误信息里出现
Your platform does not meet the minimum requirements，就说明触发了这个检查
跳过之后依赖还能正常工作吗
不一定。跳过只是让 Composer 继续安装，不保证代码真能跑起来。比如你忽略 ext-redis，但项目代码里直接调了 Redis::connect()，运行时照样报 Class 'Redis' not found。
- 优先确认：报错的是 Composer 安装阶段，还是运行时报的 Fatal Error？前者可跳过，后者必须补环境
- 本地开发建议用
docker run --rm -v $(pwd):/app -w /app php:8.2-cli composer install确保环境一致 - 忽略扩展比忽略 PHP 版本风险更高——扩展缺失通常导致运行时崩溃，而非安装失败
- 某些包（如
symfony/console）会根据 PHP 版本启用不同特性，跳过可能导致行为差异
config.platform 却没同步文档的时候。 
