应使用--ignore-platform-req=php精准跳过PHP版本检查，它仅绕过"php": "^8.2"类声明，保留ext-*扩展校验；而--ignore-platform-reqs会跳过所有平台检查，极易导致运行时Class 'Redis' not found等错误。
直接加 --ignore-platform-req=php 就能跳过 PHP 版本检查，但别乱用 --ignore-platform-reqs（带 s），它会一并跳过所有扩展校验，运行时大概率报 Class 'Redis' not found 或语法错误。
为什么 composer install 卡在 “Your PHP version does not satisfy that requirement”
这不是网络或权限问题，是 Composer 主动拒绝安装：你本地是 PHP 8.0，但 composer.json 或某个依赖写了 "php": "^8.2"，它连依赖树都不开始算，直接退出。
- 错误信息里明确出现
php ^8.2、php >=8.3这类字样 → 是纯 PHP 版本冲突，--ignore-platform-req=php精准解决 - 同时提示
ext-gd is missing或ext-mbstring→ 别一股脑加--ignore-platform-reqs，先确认是否真需要该扩展；若只是开发调试，可单独加--ignore-platform-req=ext-gd - 运行
php -v和composer install -v，看第一行报错到底卡在哪条php还是哪个ext-，别靠猜
--ignore-platform-req=php 和 --ignore-platform-reqs 的实际区别
前者只绕过 PHP 版本声明（如 "php": "^8.1"），后者跳过全部：PHP 版本、所有 ext-*、lib-*，甚至架构（php-64bit）——风险高得多。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer install --ignore-platform-req=php：安全边界最清晰，推荐作为默认尝试 -
composer install --ignore-platform-req=ext-redis --ignore-platform-req=ext-gd：多个扩展要忽略，就重复写多次--ignore-platform-req=，别用逗号分隔（无效） -
composer install --ignore-platform-reqs：CI 构建中慎用；Docker 多阶段构建时，builder 镜像加了它，但 runtime 镜像没装对应扩展，部署后必崩 - 注意拼写：
--ignore-platform-reqs（带s）是合法参数；--ignore-platform-req（不带s）会被 Composer 忽略，不报错也不生效
CI/CD 或 Docker 中更稳妥的替代方案
硬跳过检查不是长久之计。长期协作或自动化流程中，优先用 config.platform 模拟目标环境，避免污染 composer.lock 和误导队友。
立即学习“PHP免费学习笔记（深入）”；
- 临时覆盖（不写入文件）：
composer install --platform=php:8.2.10 --platform=ext-zip:1.20.0，比全局忽略更可控 - 永久声明（写入
composer.json）："config": {"platform": {"php": "8.2.10"}}—— 注意版本号必须完整，"php": "8.2"会解析失败 - 删
composer.lock再install不是“忽略”，而是强制重算整个依赖图；它对版本冲突有效，但对平台要求无效 - 如果
composer.lock提示lock file not compatible，说明composer.json改了但 lock 没更新，此时--ignore-platform-reqs完全无效，该用composer update --lock或直接删 lock
装上了，但运行时报错？这才是真正容易被忽略的点
--ignore-platform-req=php 只管安装阶段，不管运行时。PHP 8.2 装了声明只兼容 8.3 的包，可能因为用了 match 表达式或只读属性，在第一次 require 时就 Fatal error；某些命令行工具（如 phpunit、larastan）启动时还会自己再校验一次 PHP 版本，这时 Composer 的参数已经没用了。
- 运行前先跑
php -l vendor/autoload.php，确认基础加载无语法错误 - 检查关键类是否被正确加载：
php -r "var_dump(class_exists('Monolog\Logger'));" - 如果报扩展缺失，别只盯着 Composer 参数——去容器或服务器上手动执行
php -m | grep redis，确认扩展真没装，而不是 Composer 没校验到 - autoload 失败有时和 platform 设置间接相关：比如因跳过检查装了旧版
symfony/polyfill-mbstring，而它又依赖ext-mbstring的条件加载逻辑，结果类根本没注册进 autoloader
