vendor/composer/package-versions-deprecated/src/PackageVersions/Versions.php line 55

Open in your IDE?
  1. <?php
  3. declare(strict_types=1);
  5. namespace PackageVersions;
  7. use Composer\InstalledVersions;
  8. use OutOfBoundsException;
  9. use UnexpectedValueException;
  11. class_exists(InstalledVersions::class);
  13. /**
  14.  * This is a stub class: it is in place only for scenarios where PackageVersions
  15.  * is installed with a `--no-scripts` flag, in which scenarios the Versions class
  16.  * is not being replaced.
  17.  *
  18.  * If you are reading this docBlock inside your `vendor/` dir, then this means
  19.  * that PackageVersions didn't correctly install, and is in "fallback" mode.
  20.  */
  21. final class Versions
  22. {
  23.     /**
  24.      * @deprecated please use {@see self::rootPackageName()} instead.
  25.      *             This constant will be removed in version 2.0.0.
  26.      */
  27.     const ROOT_PACKAGE_NAME = 'unknown/root-package@UNKNOWN';
  29.     /** @internal */
  30.     const VERSIONS          = [];
  32.     private function __construct()
  33.     {
  34.     }
  36.     /**
  37.      * @psalm-pure
  38.      *
  39.      * @psalm-suppress ImpureMethodCall we know that {@see InstalledVersions} interaction does not
  40.      *                                  cause any side effects here.
  41.      */
  42.     public static function rootPackageName() : string
  43.     {
  44.         if (!class_exists(InstalledVersions::class, false) || !InstalledVersions::getRawData()) {
  45.             return self::ROOT_PACKAGE_NAME;
  46.         }
  48.         return InstalledVersions::getRootPackage()['name'];
  49.     }
  51.     /**
  52.      * @throws OutOfBoundsException if a version cannot be located.
  53.      * @throws UnexpectedValueException if the composer.lock file could not be located.
  54.      */
  55.     public static function getVersion(string $packageName): string
  56.     {
  57.         if (!class_exists(InstalledVersions::class, false) || !InstalledVersions::getRawData()) {
  58.             return FallbackVersions::getVersion($packageName);
  59.         }
  61.         /** @psalm-suppress DeprecatedConstant */
  62.         if ($packageName === self::ROOT_PACKAGE_NAME) {
  63.             $rootPackage = InstalledVersions::getRootPackage();
  65.             return $rootPackage['pretty_version'] . '@' . $rootPackage['reference'];
  66.         }
  68.         return InstalledVersions::getPrettyVersion($packageName)
  69.             . '@' . InstalledVersions::getReference($packageName);
  70.     }
  71. }