yaffs.net Git - yaffs-website/blob - vendor/composer/semver/src/Semver.php

   1 <?php
   2
   3 /*
   4  * This file is part of composer/semver.
   5  *
   6  * (c) Composer <https://github.com/composer>
   7  *
   8  * For the full copyright and license information, please view
   9  * the LICENSE file that was distributed with this source code.
  10  */
  11
  12 namespace Composer\Semver;
  13
  14 use Composer\Semver\Constraint\Constraint;
  15
  16 class Semver
  17 {
  18     const SORT_ASC = 1;
  19     const SORT_DESC = -1;
  20
  21     /** @var VersionParser */
  22     private static $versionParser;
  23
  24     /**
  25      * Determine if given version satisfies given constraints.
  26      *
  27      * @param string $version
  28      * @param string $constraints
  29      *
  30      * @return bool
  31      */
  32     public static function satisfies($version, $constraints)
  33     {
  34         if (null === self::$versionParser) {
  35             self::$versionParser = new VersionParser();
  36         }
  37
  38         $versionParser = self::$versionParser;
  39         $provider = new Constraint('==', $versionParser->normalize($version));
  40         $constraints = $versionParser->parseConstraints($constraints);
  41
  42         return $constraints->matches($provider);
  43     }
  44
  45     /**
  46      * Return all versions that satisfy given constraints.
  47      *
  48      * @param array $versions
  49      * @param string $constraints
  50      *
  51      * @return array
  52      */
  53     public static function satisfiedBy(array $versions, $constraints)
  54     {
  55         $versions = array_filter($versions, function ($version) use ($constraints) {
  56             return Semver::satisfies($version, $constraints);
  57         });
  58
  59         return array_values($versions);
  60     }
  61
  62     /**
  63      * Sort given array of versions.
  64      *
  65      * @param array $versions
  66      *
  67      * @return array
  68      */
  69     public static function sort(array $versions)
  70     {
  71         return self::usort($versions, self::SORT_ASC);
  72     }
  73
  74     /**
  75      * Sort given array of versions in reverse.
  76      *
  77      * @param array $versions
  78      *
  79      * @return array
  80      */
  81     public static function rsort(array $versions)
  82     {
  83         return self::usort($versions, self::SORT_DESC);
  84     }
  85
  86     /**
  87      * @param array $versions
  88      * @param int $direction
  89      *
  90      * @return array
  91      */
  92     private static function usort(array $versions, $direction)
  93     {
  94         if (null === self::$versionParser) {
  95             self::$versionParser = new VersionParser();
  96         }
  97
  98         $versionParser = self::$versionParser;
  99         $normalized = array();
 100
 101         // Normalize outside of usort() scope for minor performance increase.
 102         // Creates an array of arrays: [[normalized, key], ...]
 103         foreach ($versions as $key => $version) {
 104             $normalized[] = array($versionParser->normalize($version), $key);
 105         }
 106
 107         usort($normalized, function (array $left, array $right) use ($direction) {
 108             if ($left[0] === $right[0]) {
 109                 return 0;
 110             }
 111
 112             if (Comparator::lessThan($left[0], $right[0])) {
 113                 return -$direction;
 114             }
 115
 116             return $direction;
 117         });
 118
 119         // Recreate input array, using the original indexes which are now in sorted order.
 120         $sorted = array();
 121         foreach ($normalized as $item) {
 122             $sorted[] = $versions[$item[1]];
 123         }
 124
 125         return $sorted;
 126     }
 127 }