如何查询Composer中某个包的所有可用版本
composer show 能查到所有版本吗
答案是不能。直接执行 composer show 命令，默认仅会显示当前项目已安装的特定版本，或告知该包最新的稳定版信息。对于那些历史发布版本，或是处于开发阶段的 dev-、alpha、beta 等非稳定版本，此命令并不会完整列出。若需查看包的全部版本记录，必须使用其他特定命令。
使用 composer show -a 查看全部可用版本
要获取完整的版本列表，composer show -a 是正确的选择。此命令会直接向 Packagist 官方仓库请求元数据，并返回该包所有已发布的版本，包括稳定版、开发版及预发布版。关键在于，Composer 通常会依据项目 composer.json 中配置的 minimum-stability（最低稳定性要求）和 prefer-stable（优先使用稳定版）参数来筛选版本。添加 -a 参数后，将强制忽略这些过滤规则，展示所有可用的版本信息。
具体操作步骤如下：
- 在命令行中执行
composer show -a vendor/package-name。例如，查询 Monolog 日志库的所有版本，可输入composer show -a monolog/monolog。 - 若系统返回 “Package not found” 错误，请先检查包名拼写是否正确。此外，私有包通常未在公开的 Packagist 注册，需在
composer.json中单独配置私有仓库地址才能查询。 - 在输出的列表中，您可能会看到以
dev-为前缀的版本（如dev-main）。这些版本通常对应 Git 仓库中的分支，而非正式的标签发布版。如需安装此类版本，请在版本号后附加@dev后缀。 - 首次执行此命令时，由于需要从远程 API 获取数据，响应可能较慢。如需了解详细过程，可添加
-v参数查看网络请求的详细日志。
为什么 composer search 无法查询版本
许多开发者误用 composer search 命令来查找版本信息，这其实是一种误解。该命令的核心功能是根据关键词搜索包名和描述，返回的是相关的包列表，并不提供任何具体的版本数据。其本质是调用 Packagist 的搜索接口，而非获取单个包的版本树。
错误使用此命令的典型表现如下：
- 执行
composer search monolog，结果会返回数十个名称中包含 “monolog” 的包，但不会显示任何版本号。 - 尝试为其添加
--all或-a参数，通常会收到 “unrecognized option” 的错误提示，因为该命令不支持此类参数。
如何通过脚本获取版本列表：使用 composer show -a --format=json
若您需要通过脚本自动化处理版本信息，纯文本输出格式并不便于解析。此时，组合命令 composer show -a --format=json 是更可靠的方案。该命令会输出结构化的 JSON 数据，其中包含一个 versions 数组，数组中的每个元素即代表一个版本字符串，例如 "2.9.0" 或 "dev-main"。
使用此方法时需注意以下几点：
- 输出的 JSON 内容较为简洁，仅包含版本字符串本身，不包含发布时间、稳定性等元数据。
- 如果您的 Composer 版本较旧（低于 2.0），可能不支持
--format=json参数。建议先执行composer --version确认当前版本。 - 对于私有包，若您使用的是自建的 Satis 或 SatisPress 仓库，需确保仓库配置正确，已启用
providers-url并支持/packages/{vendor}/{package}.json接口，否则命令可能无法获取数据。
对于大多数日常开发场景，composer show -a 已能满足需求。但最后需要特别提醒：此命令查询到的仅是 Packagist 上当前仍存在的版本。如果某个版本因安全漏洞等原因被作者撤回（yank），或已从 Packagist 彻底删除，则不会出现在查询结果中。这一细节常被开发者忽略。
