composer show 只查 Composer 包,查 PHP 扩展需用 composer show --platform;查包版本要写全名如 guzzlehttp/guzzle;--all 才能看所有远程版本;命令依赖 vendor/composer/installed.json 文件。

composer show 不能直接“查扩展包”,它只认 Composer 包,不识别 PHP 扩展(如 gd、mbstring)——想看 PHP 环境里装了哪些扩展,得用 composer show --platform。
查 PHP 扩展和平台信息,必须用 --platform
很多人输 composer show gd 或 composer show ext-gd,结果报错 Package not found。这不是命令写错了,是概念混淆:composer show 查的是通过 Composer 安装的 PHP 库(比如 monolog/monolog),不是 PHP 自带或通过系统包管理器安装的扩展。
composer show --platform 才是正确入口,它读取当前 PHP CLI 的真实运行环境:
- 显示 PHP 版本(如
php 8.2.12) - 列出所有已启用的扩展及其版本(如
ext-gd 8.2.12、ext-pdo_mysql 8.2.12) - 包含
lib-*类库(如lib-iconv 2.39)
典型误判场景:安装包时报错 The requested package ext-gd could not be found,此时运行 composer show --platform | grep gd 就能立刻确认是没启用,而不是 Composer 配置问题。
查某个 Composer 包的当前安装版本,必须写全名 + 不加 --all
想确认项目里 guzzlehttp/guzzle 到底装的是 v7.8.1 还是 dev-main?直接跑:
composer show guzzlehttp/guzzle
输出里的 versions 行就是真实安装版本。注意几个硬性条件:
- 包名必须全小写、带 vendor,
guzzle或GuzzleHttp/Guzzle都会失败 - 如果该包只在
require-dev里,且你上次用了composer install --no-dev,它就不会出现在结果中 - 不加任何参数时,
composer show只列顶层包,不展开依赖树;要查它依赖了谁、被谁 require,得加--tree
别指望靠这个命令“搜索”包名——它不模糊匹配,也不支持通配符。
查远程所有可用版本(含最新 tag),--all 是唯一可靠方式
想知道 guzzlehttp/guzzle 有没有 v8.0.0 可升?运行:
composer show --all guzzlehttp/guzzle
关键点:
-
--all是双横线,-a是无效别名,会被忽略 - 默认走本地缓存,可能看不到刚发布的版本;加
--no-cache强制直连 Packagist(如composer show --all guzzlehttp/guzzle --no-cache) - 私有包必须先在
composer.json的repositories里声明,否则查不到 - 输出里只有包名和简短描述,不含 PHP 兼容性等元数据;要看某具体版本(如 v7.9.0)是否适配你的环境,得单独查:
composer show guzzlehttp/guzzle 7.9.0
过滤稳定版可配合 grep 或 jq,例如只留三位数字版本:composer show --all guzzlehttp/guzzle | grep -E '^[[:space:]]*[0-9]+\.[0-9]+\.[0-9]+' | tr -d ' '。
常见坑:vendor 目录不存在,所有 show 命令都失效
composer show 系列命令全部依赖 vendor/composer/installed.json,不是读 composer.lock,更不回退到源码解析。所以:
- 刚 clone 项目但还没
composer install?composer show报错或空输出 - 手动删了
vendor目录?所有show命令立即失效,哪怕composer.lock完好无损 - CI 环境里想用
show校验依赖,必须确保composer install已执行完成,且没加--no-scripts导致installed.json未生成
真正容易被忽略的是:这个文件由 Composer 自动维护,内容格式随 Composer 大版本变化(如 2.x 和 3.x 的字段结构不同),脚本里硬解析它比直接调 composer show --format=json 更不可靠。











