composer install 因 php 版本报错是因平台版本校验失败；可用 --ignore-platform-req=php 跳过 php 版本检查，但不解决运行时兼容性问题，需谨慎确认代码实际兼容性。
为什么 composer install 会因为 PHP 版本报错？
Composer 默认会校验你本地 PHP 版本是否满足 composer.json 中 config.platform.php 或依赖包声明的 php 版本要求。一旦不匹配（比如包要求 ^8.1，而你用的是 7.4），就会中断安装并抛出类似错误：Your platform does not meet the minimum requirements。
这不是 Composer 故意卡你，而是它在帮你规避运行时兼容性风险——但有时你清楚自己要做什么（比如临时测试、CI 环境降级、或确认某个包真能在低版本跑），就得绕过这层检查。
--ignore-platform-req 和 --ignore-platform-reqs 的区别
这两个参数名字像，作用差得远：
-
--ignore-platform-req=php：只忽略对php版本的检查，其他平台依赖（如ext-curl、lib-*）照常校验 -
--ignore-platform-reqs：一口气跳过所有平台约束，包括 PHP 版本、扩展、库版本等
多数情况下，你真正想跳过的只是 PHP 版本，所以优先用 --ignore-platform-req=php，避免掩盖真实缺失的扩展问题。
立即学习“PHP免费学习笔记（深入）”；
怎么安全地跳过 PHP 版本检查？
直接加参数最简单，但要注意执行时机和作用范围：
- 对单次命令生效：
composer install --ignore-platform-req=php - 跳过多个平台项：
composer update --ignore-platform-req=php --ignore-platform-req=ext-gd - 写进
composer.json（不推荐长期使用）："config": { "platform": { "php": "8.1.0" } }——这其实是“伪造”平台版本，不是跳过，且会影响所有依赖解析逻辑 - CI/CD 中建议显式传参，而不是改配置，避免污染本地开发环境
注意：--ignore-platform-req 不接受模糊值（比如不能写 --ignore-platform-req=^8），只能填具体键名，常见可填值有：php、ext-zip、lib-iconv 等。
跳过之后，真的就没事了吗？
不会。跳过检查 ≠ 兼容运行。比如一个包用了 PHP 8.1 的枚举类，你在 PHP 7.4 上强行装完，require 时直接 Fatal error: Uncaught Error: Undefined constant。
所以务必确认两点：
- 目标包是否真没用高版本语法/特性（查它的
src/或CHANGELOG） - 你的代码路径是否实际会触发那些新特性（有些功能是条件加载的）
最稳妥的做法：先用 --dry-run 看拟安装结果，再结合 composer show vendor/package 查它的真实 require.php 值，最后决定要不要跳——别让 --ignore-platform-req=php 成为掩盖兼容性问题的习惯性操作。
