应使用--ignore-platform-req=php精准跳过PHP版本检查，而非--ignore-platform-reqs；前者仅绕过"php": "^8.2"类声明，保留ext-*等扩展校验，避免运行时因缺失扩展或语法不兼容崩溃。
composer install 报 “PHP 版本不满足” 时该用哪个参数
直接用 --ignore-platform-req=php，不是 --ignore-platform-reqs。前者只跳过 PHP 版本比对，后者会一并忽略 ext-gd、ext-redis 等所有扩展检查，极易导致运行时报 Class 'Redis' not found 或语法解析失败。
常见错误现象：本地是 PHP 8.0，但 composer.json 写了 "php": "^8.2"，执行 composer install 直接中断，提示 Root composer.json requires php ^8.2 but your php version (8.0.30) does not satisfy that requirement。
-
--ignore-platform-req=php是精准解法，命令必须带等号和值，写成--ignore-platform-req php（无等号）等价于--ignore-platform-reqs，风险陡增 - 多个要忽略的项可叠加：
composer install --ignore-platform-req=php --ignore-platform-req=ext-gd - 它不影响依赖版本约束（如
"monolog/monolog": "^3.0"），只绕过平台声明校验 - 该参数仅作用于当次命令，不修改
composer.json或composer.lock
报 “Your lock file does not contain a compatible set of packages” 怎么办
这不是平台问题，--ignore-platform-req=php 完全无效。这是 composer.json 的 require 规则变了，但 composer.lock 还锁着旧版本，Composer 拒绝“睁眼装”。
典型场景：把 "monolog/monolog": "^2.0" 改成 "^3.0" 后直接 composer install，报错提示锁文件不兼容。
- 唯一有效动作是删掉
composer.lock，再跑composer install—— 此时 Composer 会彻底按新composer.json重算整个依赖树 - 想保留当前包版本？用
composer update --lock，它只更新 lock 文件结构，不改已装包版本 -
--ignore-platform-reqs在这里毫无作用，别试 - CI/CD 中务必确保
composer.lock已提交且未被.gitignore，否则每次构建可能装出不同结果
依赖冲突报 “Conclusion: don’t install X” 能不能靠 ignore 参数绕过
不能。--ignore-platform-req=php 或 --ignore-platform-reqs 对这类错误完全没用。这是 Composer SAT 求解器判定当前依赖图逻辑无解，比如 A 包硬性 require symfony/console:^5.4，而你试图装 ^6.0，根本不是环境问题。
真正该做的是定位谁在拦：composer prohibits vendor/package:v6.0.0，输出会直接告诉你哪个已装包、哪条 require 导致失败。
- 临时方案：先
composer require vendor/package:v6.0.0 --no-update写进composer.json，再composer update vendor/package --with-all-dependencies - 更稳妥的做法：降级那个冲突包，再
composer update conflicting-package - 删
composer.lock也解决不了——它只影响版本重算起点，不改变依赖间的逻辑约束 - 别迷信
--prefer-lowest，它只会让冲突更隐蔽
Docker 构建或 CI 中怎么安全用 ignore 参数
关键不是“要不要用”，而是“用得够不够细”。CI 脚本里无条件加 --ignore-platform-reqs 是高危操作：builder 阶段假装有 ext-redis，runtime 镜像却没装，部署后一调就崩。
推荐做法是分层控制：
- 构建阶段用
--ignore-platform-req=php跳过 PHP 版本检查（例如 builder 用 PHP 8.3 编译，但 runtime 是 8.1） - 同时用
composer config platform.php 8.1.0在composer.json里显式声明目标版本，让 autoload 映射生成更可靠 - 绝对不要在
composer.json里写"platform": {"php": "8.1"}（缺补零会解析失败），必须写完整语义化版本如"8.1.28" - 如果某扩展确实是可选功能（如
ext-gd只用于图像缩略图），考虑把它从require移到require-dev，或用conflict排除不兼容分支
最容易被忽略的点是：即使加了 --ignore-platform-req=php，如果项目代码用了 PHP 8.2 的 match 表达式，而你本地是 8.1，运行时照样 ParseError —— Composer 不管这个，它只管装，不管跑。
