composer怎么查看最小PHP版本要求_composer查看包PHP要求方法

composer show 显示包自身 composer.json 中的 php 版本约束，如 laravel/framework 要求 php: ^8.0 || ^8.1 || ^8.2，^8.0 表示最低支持 8.0.0；composer why-not php:8.0 检查当前环境是否满足该版本，返回冲突依赖；composer validate 验证 composer.json 中 PHP 约束语法合法性。

composer show 显示包的 PHP 版本约束

直接运行 composer show vendor/package-name 就能看到该包在 composer.json 中声明的 php 环境要求，通常出现在 require 或 require-dev 下的 php 键值对里。

比如执行 composer show laravel/framework，输出中会包含类似：

requires   php: ^8.0 || ^8.1 || ^8.2

这个 ^8.0 就是它支持的最低 PHP 版本（即 8.0.0），不是“建议版本”也不是“测试版本”，是 Composer 安装时实际校验的底线。

• 如果本地 PHP 是 7.4，composer require laravel/framework 会直接失败，并抛出 Your requirements could not be resolved to an installable set of packages.
• composer show 不会自动解析依赖树里的间接要求，只看目标包自身的 composer.json
• 有些包把 PHP 要求写在 config.platform.php 里——那是你项目强制“假装”有某个 PHP 版本，不影响 show 的原始输出

composer why-not php:8.0 判断当前环境是否满足某版本

当你不确定自己 PHP 版本能不能装某个包，又懒得翻文档，用 composer why-not php:8.0 最快。它会模拟安装 PHP 8.0 这个“虚拟包”，然后列出所有阻止它被接受的已存在依赖。

立即学习“PHP免费学习笔记（深入）”；

比如你 PHP 是 7.4，运行 composer why-not php:8.0 可能返回：

doctrine/dbal 3.6.3 requires php ^8.0 -> your PHP version (7.4.33) does not satisfy that requirement.

这说明 doctrine/dbal 卡住了升级路径——哪怕你想手动改 composer.json，它也会拦着。

• 这个命令不修改任何文件，纯检查，适合 CI 或本地快速验证
• 必须写完整版本号，php:8 不行，得是 php:8.0 或 php:8.1.10
• 如果返回空，不代表“能装”，只代表没发现冲突；仍需配合 composer show 看目标包自身要求

composer validate 检查 composer.json 里写的 PHP 要求是否合法

自己写包或维护私有库时，容易手误写错 PHP 版本约束，比如写成 "php": ">=7.4,（少了个点）或者 "php": "8.0"（没加约束符）。这些会导致别人安装时报奇怪错误，但 composer validate 能提前揪出来。

它会校验 composer.json 中 php 字段是否符合 SemVer 规则，以及是否和 platform 配置冲突。

• 错误示例："php": "7.4" → 报 [InvalidConstraintException] Invalid version constraint "7.4"
• 正确写法只有几种：^7.4、>=7.4.0、~8.0.0、>=8.0
• 注意：这个命令不检查你本地 PHP 版本，只校验 JSON 语法和约束格式

vendor/composer/installed.php 里 runtime 实际生效的 PHP 版本

装完包后，Composer 会在 vendor/composer/installed.php 里记录每个包的元信息，其中 runtime 键下的 php 值，是你当前环境真实“跑通”的 PHP 版本（来自 PHP_VERSION），不是包声明的要求。

这个值只在安装/更新时写入，不会动态刷新。它常被某些监控脚本或部署工具读取，用来确认运行时一致性。

• 不要手动改这个文件，改了也没用，下次 composer install 就覆盖
• 它的作用是记录“当时装的时候 PHP 是多少”，不是用于兼容性判断
• 如果你看到里面写的是 "php": "8.2.12"，但 php -v 显示 8.2.8，说明你可能混用了不同 PHP SAPI（比如 CLI 和 FPM 版本不一致）

最常被忽略的是：包的 PHP 要求可能藏在 require-dev 里，而 composer show 默认不显示开发依赖。需要加 -s dev 才能看到，否则你以为能装，结果 composer install --no-dev 成功，--with-all-dependencies 却失败。