如何利用 composer 提供的 InstalledVersions 类检查包版本？

InstalledVersions类自Composer 2.0+引入，用于运行时检查已安装包的版本信息。通过getVersion()可获取指定包版本，isInstalled()判断包是否存在，getInstalledPackages()获取所有已安装包名，getRawData()获取包含版本、路径等详细信息的数组。在嵌套依赖场景下，建议使用isInstalled('package', false)以检测当前作用域内的可用性。开发者可利用version_compare结合getVersion()实现兼容性判断，确保代码适配不同依赖版本。该类由Composer自动生成于vendor/composer/InstalledVersions.php，执行install或update后即可使用，需确保Composer版本不低于2.0。

Composer 提供了 InstalledVersions 类来帮助你在运行时检查已安装的 Composer 包版本。这个类在 Composer 2.0+ 中引入，特别适用于库开发者或需要兼容多版本依赖的项目。

启用 InstalledVersions

Composer 会自动生成 InstalledVersions 类，通常位于 vendor/composer/InstalledVersions.php。只要项目使用了 Composer 并执行过 composer install 或 composer update，这个类就可以直接使用。

常用方法和用法示例

以下是一些常用的检查方式：

• 检查某个包是否存在并获取其版本

  $version = \Composer\InstalledVersions::getVersion('monolog/monolog');
  if ($version) {
      echo "monolog/monolog 版本: " . $version;
  } else {
      echo "monolog/monolog 未安装";
  }

• 判断某个包是否已安装

  if (\Composer\InstalledVersions::isInstalled('symfony/http-foundation')) {
      echo "symfony/http-foundation 已安装";
  }

• 获取所有已安装的包名

  $packages = \Composer\InstalledVersions::getInstalledPackages();
  print_r($packages);

• 获取更详细的包信息（包括版本、安装路径等）

  $info = \Composer\InstalledVersions::getRawData();
  // 返回包含所有包详细信息的数组
  print_r($info['versions']['monolog/monolog']);

处理不同 Composer 安装场景

在某些情况下（如插件或嵌套依赖），你可能处于“非根项目”环境中。这时建议使用：

Facet

Facet.ai是一款AI图像生成和编辑工具，具备实时图像生成和编辑功能

下载

\Composer\InstalledVersions::isInstalled('your/package', false)

第二个参数设为 false 表示不限于根项目，可用于判断在当前作用域中是否可用。

基本上就这些。通过 InstalledVersions，你可以安全地做版本兼容判断，比如：

if (version_compare(\Composer\InstalledVersions::getVersion('my/package'), '2.1.0', '>=')) {
    // 使用新特性
}