直接加--ignore-platform-req=php即可绕过PHP版本检查，继续安装；它只跳过"php": "^7.4"类声明，不跳过ext-*等扩展校验，安全且常用。

直接加 --ignore-platform-req=php 就能绕过 PHP 版本检查，继续安装。这是最安全、最常用的做法——它只跳过 "php": "^7.4" 或 "php": ">=8.2" 这类声明，不碰任何扩展（如 ext-gd）、库或架构校验。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

---

composer install 报 “Your PHP version does not satisfy that requirement” 怎么办

• 错误里明确出现 php ^8.2、php >=8.3 等字样 → 是纯 PHP 版本冲突，不是依赖解析失败，也不是网络问题
• 先确认真实版本：php -v，再看 composer.json 或报错中引用的约束值
• 不要一上来就加 --ignore-platform-reqs（带 s），它会跳过所有平台项，包括 ext-redis、lib-curl，极易导致运行时报 Class 'Redis' not found
• 正确命令：
  • composer install --ignore-platform-req=php
  • composer update --ignore-platform-req=php
  • composer create-project laravel/laravel myapp --ignore-platform-req=php
• 注意：--ignore-platform-req=php 后不能跟版本号（比如 =8.0），否则参数无效

---

为什么不用 --ignore-platform-reqs（带 s）

• 它跳过全部平台检查：PHP 版本、所有 ext-<em></em>、lib-、甚至 php-64bit
• 表面装成功，但运行时可能立刻崩：
  • 本地没装 ext-redis，却靠它装上了 Laravel Octane → php artisan octane:start 直接报错
  • Docker 构建中 builder 镜像用了它，runtime 镜像没装对应扩展 → 上线后接口全 500
  • CI 脚本无条件加它，队友 clone 下来照样失败，因为缺失的扩展并没 magically 出现
• 拼写必须是 --ignore-platform-reqs（带 s），--ignore-platform-req（不带 s）会被 Composer 忽略，不报错也不生效

---

composer.json 里设 "platform" 的坑点

• 永久声明目标 PHP 版本，写法必须严格："config": {"platform": {"php": "8.2.10"}}
• "php": "8.2" 会解析失败，版本号必须完整（含小版本和补丁号）
• 它只影响依赖解析阶段，不改变运行时行为：
  • 你本地是 PHP 7.4，却设了 "php": "8.2.10" → composer install 能过，但代码里用 match 表达式会直接 ParseError
  • 该配置提交到 Git 后，队友环境不一致，有人装成功、有人运行时报错，协作成本陡增
• 设完必须跑 composer update --lock，否则 composer.lock 仍记录旧平台元信息

真正容易被忽略的是：即使加了 --ignore-platform-req=php，如果项目代码本身用了高版本语法（比如 PHP 8.1 的 enum），而你本地 PHP 是 8.0，运行时照样 fatal error。忽略检查 ≠ 解决兼容性。