—ignore-platform-reqs仅跳过安装前php版本、扩展、系统库校验，不保障运行时可用性；如缺ext-redis仍会报class 'redis' not found，php语法不兼容亦致fatal error。
—ignore-platform-reqs 只跳过安装前校验，不解决运行时崩溃
它不是“兼容模式”，而是关掉 Composer 的环境安检闸机——让包装进去，但闸机后有没有路、路通不通，它不管。你本地没 ext-redis，加了这个参数照样能 composer install 成功；可只要代码里调用 new Redis()，运行时立刻报 Class 'Redis' not found。
常见错误现象：
- CI 构建通过，部署后首页 500，日志里只有
Fatal error: Uncaught Error: Call to undefined function str_starts_with() -
composer install --ignore-platform-reqs完事，php artisan tinker进去一敲就崩，提示undefined function mb_strlen() - 本地 PHP 是 8.1，锁文件记的是 8.2+ 解析出的依赖，装完发现
match表达式语法直接 fatal
只跳 PHP 版本检查：用 --ignore-platform-req=php，别写成 =8.1
这个参数值必须是 php 字符串本身，不是版本号。写成 --ignore-platform-req=8.1 或 --ignore-platform-req="^8.1" 都无效，Composer 会静默忽略或报错。
适用场景：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- CI 环境 PHP 小版本略低（如本地 8.2.10，锁文件由 8.2.12 生成），但所有扩展和系统库完全一致
- 你确认项目没用 PHP 8.2+ 新语法（如
readonly类、enum析构器），且所有依赖包在 8.2.10 下实测运行正常 - 想保留对
ext-gd、ext-mbstring等扩展的强制检查，避免漏掉真正要命的缺失项
精准跳过某个扩展：--ignore-platform-req=ext-gd 大小写敏感
值必须严格匹配 composer.json 或依赖包 require 中声明的平台名。比如包要求 "ext-imagick": "*"，你就得写 --ignore-platform-req=ext-imagick，写成 imagick 或 ext-Imagick 都不生效。
注意点：
- 只跳过“是否加载”的检查，不跳过“是否可用”——即使你写了
--ignore-platform-req=ext-gd，如果gd_info()返回 false（比如 lib-jpeg 版本太低），图像处理仍会失败 - 多个扩展可叠加：例如
composer install --ignore-platform-req=ext-gd --ignore-platform-req=ext-igbinary - 不推荐在生产部署脚本里硬编码这类参数，容易掩盖环境漂移；更适合开发调试或 CI 中已知某扩展纯属可选路径
—ignore-platform-reqs 和删 composer.lock 是两回事
前者只绕过 php、ext-*、lib-* 三类平台检查；后者才影响依赖版本解析逻辑。如果你看到报错是 Could not resolve packages 或 your requirements could not be resolved，加 --ignore-platform-reqs 完全无效——那属于语义化版本冲突，得查 composer prohibits xxx 或重生成锁文件。
真正容易被忽略的地方：
-
composer create-project同样受平台检查限制，且--no-interaction不起作用，必须显式加--ignore-platform-reqs - 项目
composer.json里若配置了"config": {"platform": {"php": "8.3.0"}}，这个设定优先级高于本地真实版本，不加参数根本不会开始下载 - 运行时崩溃往往比安装失败更难定位——因为错误发生在首次请求、队列任务或 Artisan 命令里，而不是
composer install那一刻
