--ignore-platform-reqs仅跳过安装前PHP版本、扩展及系统库校验，不解决运行时缺失依赖问题；如缺ext-redis仍报Class 'Redis' not found，PHP语法不兼容亦致Fatal error。
为什么--ignore-platform-reqs会让composer install成功但运行时崩溃
它不改环境，只绕过安装前的“门禁检查”。Composer 看到 ext-redis 在 require 里写了，但你本地没装——加了 --ignore-platform-reqs，它就当没看见，照常把包解压进 vendor/。可一旦代码执行到 new \Redis()，PHP 还是会报 Class 'Redis' not found。这不是 Composer 欺骗了你，是你让 Composer 忽略了它本该拦住你的那道防线。
常见误判点：
- 看到
Root composer.json requires php ^8.2就加--ignore-platform-reqs，结果装上 Laravel 11 后php artisan直接Fatal error: Uncaught Error: Undefined constant "FILTER_VALIDATE_BOOL"（PHP 8.1 不支持） - 用
--ignore-platform-reqs装了依赖ext-sodium的包，但没在php.ini里启用扩展，运行时报extension_loaded('sodium') === false -
config.platform.php硬编码为"8.2.0"时，--ignore-platform-reqs完全无效，必须先composer config --unset config.platform
--ignore-platform-req=php 和 --ignore-platform-reqs 的实际差异
前者只对 PHP 版本睁一只眼，后者连 ext-*、lib-*、INI 设置全放行。CI 脚本里写 composer install --ignore-platform-reqs 看似省事，实则埋雷：
- 缺
ext-gd？用--ignore-platform-req=ext-gd即可，ext-mbstring和php版本仍受校验 - 想跳过 PHP 版本但保留所有扩展检查？Composer 没这个开关，得配合
config.platform“假装”版本，例如："config": {"platform": {"php": "8.1.28"}}（注意必须是完整语义化版本） - 拼错参数名毫无效果：
--ignore-platform-req ext-gd（少个s）会被忽略，命令照样失败；正确写法是--ignore-platform-req=ext-gd
composer install vs composer update 加参数的风险区别
install 时加 --ignore-platform-req=xxx 只影响本次安装决策，锁文件（composer.lock）记录的仍是原始兼容版本；而 update 时加，会改变依赖解析逻辑，可能把本不该选的高版本写进锁文件。
典型后果：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer update --ignore-platform-req=php在 PHP 8.1 环境下，可能把symfony/console从 v6 升到 v7（要求 PHP 8.2+），锁文件从此“污染”，其他成员composer install也会装上这个不兼容版本 -
composer install --ignore-platform-reqs是临时补救，composer update --ignore-platform-reqs是主动引入技术债 - CI 中应只对
install使用，且优先确保镜像版本匹配（如 Laravel 11 →php:8.2-cli），而非靠参数兜底
真正该忽略的，往往不是平台要求本身
很多报错看似是平台问题，实则是锁文件过期或依赖冲突。比如提示 platform requirements mismatch，先运行：
composer prohibits foo/bar:1.2.3
看输出是不是 laravel/framework v10.32.1 requires php ^8.1 —— 那说明问题在依赖树逻辑，不是你 PHP 版本低，而是你试图装一个和现有框架不兼容的包。
更安全的路径：
- 锁文件过期？用
composer update --lock重算兼容版本，不改依赖树 - 只是开发环境缺某个非核心扩展？在
composer.json的config.platform里声明它存在，比全局忽略更可控 - 运行时报
Class not found？90% 是自动加载没覆盖，不是平台忽略导致的，先查composer dump-autoload和包的autoload声明
平台忽略不是开关，是手术刀——用错位置，切开的是自己项目的稳定性。
