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 却失败。











