Composer 默认严格校验 PHP 版本和扩展，不匹配则阻断安装；推荐用 config.platform 在 composer.json 中伪造环境以安全绕过，或临时用 --ignore-platform-req 参数。
Composer 默认会严格校验当前 PHP 版本和已启用扩展是否满足 composer.json 中的 platform 或依赖包的 require 声明，遇到不匹配就报错（如 Your PHP version (7.4.33) does not satisfy that requirement）。这不是“警告”，而是阻断安装的硬性检查——想跳过它，必须显式干预。
用 platform 配置伪造运行环境
这是最常用、也最安全的绕过方式：告诉 Composer “我假装有这个版本或扩展”，而不是真的去改系统 PHP。它只影响当前项目的依赖解析，不影响实际运行时行为。
- 在项目根目录的
composer.json中添加config.platform字段 -
platform下可覆盖php版本、任意扩展（如ext-gd、ext-mbstring）甚至lib-*（如lib-iconv） - 值必须是字符串，例如
"7.4.33"或"*"（通配符表示“存在即可”，但某些扩展不支持*，建议写具体版本或"0"）
{
"config": {
"platform": {
"php": "8.1.0",
"ext-gd": "0",
"ext-mbstring": "0",
"ext-xml": "0"
}
}
}之后执行 composer install 或 composer update，Composer 就会按你声明的“平台”来解析依赖，不再校验真实环境。
临时禁用检查：用 --ignore-platform-req 参数
适合一次性调试或 CI 环境中快速验证，不修改配置文件。注意：它不能只忽略部分要求，要么全关，要么指定具体项。
立即学习“PHP免费学习笔记（深入）”；
-
composer install --ignore-platform-req：完全跳过所有平台检查（PHP 版本 + 所有扩展） -
composer install --ignore-platform-req=php：仅忽略 PHP 版本检查 -
composer install --ignore-platform-req=ext-gd：仅忽略ext-gd扩展检查 - 多个需重复写参数，例如：
--ignore-platform-req=php --ignore-platform-req=ext-mbstring
该参数不会改变锁文件（composer.lock）中的平台信息，下次不加参数仍会报错。
为什么 platform.config 比全局 config 更可靠
有人尝试用 composer config platform.php 8.1 写入全局配置，但这会影响所有项目，且在团队协作中极易引发隐性不一致——别人拉代码后因本地全局配置不同而安装出错。而 config.platform 写在项目 composer.json 里，随代码一起提交，保证所有人解析逻辑一致。
- 全局配置（
~/.composer/config.json）作用域太宽，调试完容易忘记清理 -
platform在composer.json中是明确的项目契约，CI/CD 流水线也能稳定复现 - 若项目依赖某扩展但你本地没装（如
ext-redis），仅靠platform声明无法让代码真正跑起来——它只解决“装得上”，不解决“跑得了”
常见陷阱与兼容性提醒
绕过检查不等于消除风险。以下情况仍会导致运行时报错或行为异常：
- 声明了
"ext-json": "0"，但实际 PHP 编译时禁用了json（极少见），json_encode仍会 fatal error - 依赖包在
install阶段通过scripts调用需要特定扩展的命令（如php-cs-fixer需ext-tokenizer），platform无法绕过这类运行时调用 - PHP 主版本跨度过大（如项目要求
^8.2，你伪造为7.4），即使装成功，运行时可能因语法（如match表达式）、函数签名变更直接崩溃 -
composer.lock中记录的是按platform解析出的包版本，若后续删掉该配置再重装，锁文件可能升级到不兼容真实环境的版本
真正要忽略检查，优先选 config.platform；临时验证用 --ignore-platform-req；永远别依赖“假装有扩展”来掩盖运行时缺失——那只是把问题从安装阶段推迟到了请求进来那一刻。
