--ignore-platform-reqs（或-n）跳过PHP版本、扩展及INI设置等平台环境校验，适用于明确知悉后果并能兜底的场景，如本地PHP 8.3但目标服务器为7.4且包约束为"^8.2"；它不解决依赖冲突或运行时扩展缺失问题，推荐优先使用composer config platform.php 7.4.33等更安全方案。
ignore-platform-reqs 是什么，不是 ignore-reqs
Composer 没有 ignore-reqs 这个参数，你搜到的多半是拼写错误或旧版误传。真正起作用的是 --ignore-platform-reqs（或简写 -n），它跳过对 PHP 版本、扩展（如 ext-mbstring）、INI 设置（如 memory_limit）等平台环境的校验。
什么时候必须用 --ignore-platform-reqs
典型场景是：你在本地开发机上 PHP 8.3，但目标服务器只有 PHP 7.4，而某个包的 composer.json 写了 "php": "^8.2" —— 此时 composer install 直接失败。加 --ignore-platform-reqs 能绕过该检查，强行生成 vendor/ 和 autoload.php。
- 仅适用于你明确知道后果且能自行兜底的情况（比如打包后手动删掉不兼容的类）
- CI/CD 流水线中慎用，容易掩盖真实环境问题
- 不能跳过语义化版本约束（如
"monolog/monolog": "^3.0"），只跳平台要求
常见错误和副作用
加了 --ignore-platform-reqs 后仍报错？大概率是以下原因：
-
composer update时触发依赖冲突（非平台问题），此时加参数无效，得先composer require xxx --no-update再手动调整composer.json - PHP 扩展缺失导致运行时报
Class not found或Call to undefined function mb_strlen()—— 参数只跳过安装时检查，不提供运行时能力 - 某些包在
install阶段执行脚本（post-install-cmd），若脚本依赖被忽略的扩展，会直接中断
示例错误：Your requirements could not be resolved to an installable set of packages. —— 这是依赖图矛盾，不是平台问题，加 --ignore-platform-reqs 不解决。
更安全的替代方案
硬上 --ignore-platform-reqs 容易埋雷。优先考虑：
- 用
composer config platform.php 7.4.33声明目标 PHP 版本，让 Composer 模拟低版本环境解析依赖 - 对特定扩展禁用检查：
composer config platform.ext-mbstring 0（表示“假装没装”） - 用
composer create-project --no-install先拉代码，再进目录手工删掉require里明显不兼容的项
平台配置写入 composer.json 的 config.platform 字段后，下次 install 自动生效，比每次敲长参数靠谱得多。
