composer 报错因严格校验 php 版本不满足 require.php 范围，--ignore-platform-reqs 可绕过但会忽略所有平台要求（含扩展），推荐改 config.platform 伪装修复并重装。
为什么composer install报“Your requirements could not be resolved”且提到PHP版本？
因为 Composer 默认严格校验当前 PHP 版本是否满足 composer.json 中 require.php 声明的版本范围（比如 "php": "^8.1"），而你本地是 PHP 7.4 或 8.0，它直接拒绝安装，连依赖解析都跳过。这不是网络或缓存问题，是平台约束拦截。
- 典型错误信息包含：
Your PHP version (7.4.33) does not satisfy that requirement. - 该检查发生在依赖解析阶段，
--no-cache或删vendor/都无效 -
composer update同样受此限制，不只是install
用--ignore-platform-reqs绕过但要注意什么？
加这个参数会让 Composer 完全跳过对 PHP、扩展（如 ext-mbstring）、甚至其他平台包（如 ext-redis）的版本检查，强行继续解析和安装。但它不解决运行时兼容性问题——装完很可能在 require 时 fatal error。
- 仅建议用于：临时调试、CI 构建中已确认环境兼容、或你明确知道某包只是声明保守（比如作者写了
"php": "^8.2"但实际代码只用了 8.0 就支持的语法） - 不要在生产部署脚本里无条件加，尤其不能写进 CI 的
composer install --ignore-platform-reqs作为常规操作 - 它会同时忽略所有平台要求，包括扩展，所以即使 PHP 版本过了，缺
ext-gd也不会报错，直到运行时报Class "GDImage" not found
--ignore-platform-reqs和--ignore-platform-req的区别
后者是前者的缩写，功能完全一样，但拼写少一个 s。Composer 会识别并自动补全为完整参数。不过建议始终写全 --ignore-platform-reqs，避免在某些旧版本 Composer（如 1.x）中因解析异常被静默忽略。
- 有效写法：
composer install --ignore-platform-reqs - 虽能用但不推荐：
composer install --ignore-platform-req（易混淆，且部分 CI 环境的 Composer 版本可能报 warning） - 想只忽略 PHP 版本而不忽略扩展？不行 —— 这个参数没有细粒度控制，必须全开或全关
更安全的替代方案：改platform配置而非硬忽略
如果你只是想让 Composer “假装”当前环境满足要求（比如本地开发用 PHP 8.0，但项目声明要 8.1+），可以修改 composer.json 的 config.platform，它会覆盖真实环境检测值，且不影响运行时行为。
{
"config": {
"platform": {
"php": "8.1.0"
}
}
}
- 这样
composer install不会报错，也不需要加任何 ignore 参数 - 比
--ignore-platform-reqs更可控，不会意外跳过扩展检查 - 注意：改完要删掉
composer.lock并重新composer install，否则 lock 文件里的 hash 还是按旧平台生成的
platform 配置需要重生成 lock 文件这一环 —— 改了 composer.json 却忘了删 composer.lock，结果还是走老解析逻辑。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
