使用 --ignore-platform-req=php 可精准跳过 PHP 版本检查，保留其他扩展和库的校验；若需忽略特定扩展如 redis，则用 --ignore-platform-req=ext-redis，多扩展可叠加指定，避免全局禁用带来的运行时风险。
composer
install 时提示 PHP 版本不兼容，怎么跳过检查？
直接加
就行，它只绕过 PHP 版本校验，其他扩展、lib 库等仍会正常检查，比全局忽略更安全。
常见错误现象：
适用场景：本地开发用 PHP 7.4，但 composer.json 要求 >=8.1，而你确认代码没用到 8.1+ 语法
命令示例：
或
注意：如果包在
字段里明确写了
，即使加了这个参数，Composer 仍会拒绝安装
只想跳过某个扩展（比如 ext-redis），不碰 PHP 版本怎么办？
用
这种写法，可以单点放行，保留其余所有平台检查逻辑。
常见错误现象：
，但你知道生产环境有，只是 CI 阶段还没装
支持多个扩展叠加写：
不能写成
（通配符不被官方支持，某些旧版可能误生效，但不可靠）
风险提示：跳过
后，若代码真调用了
，运行时直接
CI/CD 构建中反复失败，想一劳永逸禁用平台检查？
优先别“一劳永逸”，而是用
（带 s）临时绕过，配合
防止 post-install-cmd 因缺扩展崩溃。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
典型踩坑：在 GitHub Actions 里加了
，但后续
还是报错——因为脚本执行阶段才真正依赖扩展
推荐组合：
不要在
里写
并提交，这会让所有协作者失去平台校验提醒
Composer 2.5+ 可改用语义更清晰的
，效果相同，且和
不冲突
为什么改
的
不是好主意？
因为这是在骗自己，不是解决问题。把
改成
后，Composer 会据此选低版本包，可能导致依赖树错乱或功能缺失。
真实影响：Laravel 10 声明要求 PHP 8.1+，你硬改成 7.4，Composer 可能拉来一个根本没测试过的旧分支
替代做法：用
模拟目标环境（如
），它只影响依赖解析，不修改约束逻辑
关键区别：
是“告诉 Composer 我有这个能力”，
是“别查了，我不管有没有”——前者可进 Git，后者必须只出现在 CI 命令里
跨平台安装的核心不是“怎么跳过”，而是“跳过哪一项最轻量、最可控”。多数人一开始就想用
，结果运行时报错才回头排查，其实先看报错信息里具体缺什么，再精准忽略，省事又少埋雷。
--ignore-platform-req=phpYour PHP version (7.4.33) is not compatible with this packagecomposer install --ignore-platform-req=phpcomposer update --ignore-platform-req=phpconflict"php": ">=8.3"--ignore-platform-req=ext-redisRequired platform extensions missing: rediscomposer require predis/predis --ignore-platform-req=ext-redis --ignore-platform-req=ext-json--ignore-platform-req=ext-*ext-redisRedis::connect()Fatal error--ignore-platform-reqs--no-scripts--ignore-platform-reqsphp artisan optimizecomposer install --ignore-platform-reqs --no-scriptscomposer.json"platform-check": false--no-platform-check--ignore-platform-req=xxxcomposer.jsonrequire.php"php": ">=8.1""php": ">=7.4"config.platform"php": "8.1.0"config.platform--ignore-platform-req=php--ignore-platform-reqs