Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. Version.php

class Version

Same name in this branch
  1. 11.1.x vendor/phpunit/php-code-coverage/src/Version.php \SebastianBergmann\CodeCoverage\Version
  2. 11.1.x vendor/phpunit/phpunit/src/Runner/Version.php \PHPUnit\Runner\Version
  3. 11.1.x vendor/sebastian/version/src/Version.php \SebastianBergmann\Version
  4. 11.1.x vendor/composer/composer/src/Composer/Platform/Version.php \Composer\Platform\Version
  5. 11.1.x vendor/phpdocumentor/reflection-docblock/src/DocBlock/Tags/Version.php \phpDocumentor\Reflection\DocBlock\Tags\Version

Hierarchy

  • class \PharIo\Version\Version

Expanded class hierarchy of Version

8 files declare their use of Version
BundledComponent.php in vendor/phar-io/manifest/src/values/BundledComponent.php
ConstraintRequirement.php in vendor/phpunit/phpunit/src/Metadata/Version/ConstraintRequirement.php
ExcludeList.php in vendor/phpunit/phpunit/src/Util/ExcludeList.php
Extension.php in vendor/phar-io/manifest/src/values/Extension.php
Manifest.php in vendor/phar-io/manifest/src/values/Manifest.php

... See full list

173 string references to 'Version'
announcements_feed.info.yml in core/modules/announcements_feed/announcements_feed.info.yml
core/modules/announcements_feed/announcements_feed.info.yml
announcements_feed.libraries.yml in core/modules/announcements_feed/announcements_feed.libraries.yml
core/modules/announcements_feed/announcements_feed.libraries.yml
ArchiveCommand::execute in vendor/composer/composer/src/Composer/Command/ArchiveCommand.php
Executes the current command.
AutoAddedKeysSniff::process in vendor/drupal/coder/coder_sniffer/Drupal/Sniffs/InfoFiles/AutoAddedKeysSniff.php
Processes this test, when one of its tokens is encountered.
automated_cron.info.yml in core/modules/automated_cron/automated_cron.info.yml
core/modules/automated_cron/automated_cron.info.yml

... See full list

File

vendor/phar-io/version/src/Version.php, line 12

Namespace

PharIo\Version
View source
class Version {
    
    /** @var string */
    private $originalVersionString;
    
    /** @var VersionNumber */
    private $major;
    
    /** @var VersionNumber */
    private $minor;
    
    /** @var VersionNumber */
    private $patch;
    
    /** @var null|PreReleaseSuffix */
    private $preReleaseSuffix;
    
    /** @var null|BuildMetaData */
    private $buildMetadata;
    public function __construct(string $versionString) {
        $this->ensureVersionStringIsValid($versionString);
        $this->originalVersionString = $versionString;
    }
    
    /**
     * @throws NoPreReleaseSuffixException
     */
    public function getPreReleaseSuffix() : PreReleaseSuffix {
        if ($this->preReleaseSuffix === null) {
            throw new NoPreReleaseSuffixException('No pre-release suffix set');
        }
        return $this->preReleaseSuffix;
    }
    public function getOriginalString() : string {
        return $this->originalVersionString;
    }
    public function getVersionString() : string {
        $str = \sprintf('%d.%d.%d', $this->getMajor()
            ->getValue() ?? 0, $this->getMinor()
            ->getValue() ?? 0, $this->getPatch()
            ->getValue() ?? 0);
        if (!$this->hasPreReleaseSuffix()) {
            return $str;
        }
        return $str . '-' . $this->getPreReleaseSuffix()
            ->asString();
    }
    public function hasPreReleaseSuffix() : bool {
        return $this->preReleaseSuffix !== null;
    }
    public function equals(Version $other) : bool {
        if ($this->getVersionString() !== $other->getVersionString()) {
            return false;
        }
        if ($this->hasBuildMetaData() !== $other->hasBuildMetaData()) {
            return false;
        }
        if ($this->hasBuildMetaData() && $other->hasBuildMetaData() && !$this->getBuildMetaData()
            ->equals($other->getBuildMetaData())) {
            return false;
        }
        return true;
    }
    public function isGreaterThan(Version $version) : bool {
        if ($version->getMajor()
            ->getValue() > $this->getMajor()
            ->getValue()) {
            return false;
        }
        if ($version->getMajor()
            ->getValue() < $this->getMajor()
            ->getValue()) {
            return true;
        }
        if ($version->getMinor()
            ->getValue() > $this->getMinor()
            ->getValue()) {
            return false;
        }
        if ($version->getMinor()
            ->getValue() < $this->getMinor()
            ->getValue()) {
            return true;
        }
        if ($version->getPatch()
            ->getValue() > $this->getPatch()
            ->getValue()) {
            return false;
        }
        if ($version->getPatch()
            ->getValue() < $this->getPatch()
            ->getValue()) {
            return true;
        }
        if (!$version->hasPreReleaseSuffix() && !$this->hasPreReleaseSuffix()) {
            return false;
        }
        if ($version->hasPreReleaseSuffix() && !$this->hasPreReleaseSuffix()) {
            return true;
        }
        if (!$version->hasPreReleaseSuffix() && $this->hasPreReleaseSuffix()) {
            return false;
        }
        return $this->getPreReleaseSuffix()
            ->isGreaterThan($version->getPreReleaseSuffix());
    }
    public function getMajor() : VersionNumber {
        return $this->major;
    }
    public function getMinor() : VersionNumber {
        return $this->minor;
    }
    public function getPatch() : VersionNumber {
        return $this->patch;
    }
    
    /**
     * @psalm-assert-if-true BuildMetaData $this->buildMetadata
     * @psalm-assert-if-true BuildMetaData $this->getBuildMetaData()
     */
    public function hasBuildMetaData() : bool {
        return $this->buildMetadata !== null;
    }
    
    /**
     * @throws NoBuildMetaDataException
     */
    public function getBuildMetaData() : BuildMetaData {
        if (!$this->hasBuildMetaData()) {
            throw new NoBuildMetaDataException('No build metadata set');
        }
        return $this->buildMetadata;
    }
    
    /**
     * @param string[] $matches
     *
     * @throws InvalidPreReleaseSuffixException
     */
    private function parseVersion(array $matches) : void {
        $this->major = new VersionNumber((int) $matches['Major']);
        $this->minor = new VersionNumber((int) $matches['Minor']);
        $this->patch = isset($matches['Patch']) ? new VersionNumber((int) $matches['Patch']) : new VersionNumber(0);
        if (isset($matches['PreReleaseSuffix']) && $matches['PreReleaseSuffix'] !== '') {
            $this->preReleaseSuffix = new PreReleaseSuffix($matches['PreReleaseSuffix']);
        }
        if (isset($matches['BuildMetadata'])) {
            $this->buildMetadata = new BuildMetaData($matches['BuildMetadata']);
        }
    }
    
    /**
     * @param string $version
     *
     * @throws InvalidVersionException
     */
    private function ensureVersionStringIsValid($version) : void {
        $regex = '/^v?
            (?P<Major>0|[1-9]\\d*)
            \\.
            (?P<Minor>0|[1-9]\\d*)
            (\\.
                (?P<Patch>0|[1-9]\\d*)
            )?
            (?:
                -
                (?<PreReleaseSuffix>(?:(dev|beta|b|rc|alpha|a|patch|p|pl)\\.?\\d*))
            )?
            (?:
                \\+
                (?P<BuildMetadata>[0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-@]+)*)
            )?
        $/xi';
        if (\preg_match($regex, $version, $matches) !== 1) {
            throw new InvalidVersionException(\sprintf("Version string '%s' does not follow SemVer semantics", $version));
        }
        $this->parseVersion($matches);
    }

}

Members

Title Sort descending Modifiers Object type Summary
Version::$buildMetadata private property @var null|BuildMetaData
Version::$major private property @var VersionNumber
Version::$minor private property @var VersionNumber
Version::$originalVersionString private property @var string
Version::$patch private property @var VersionNumber
Version::$preReleaseSuffix private property @var null|PreReleaseSuffix
Version::ensureVersionStringIsValid private function
Version::equals public function
Version::getBuildMetaData public function
Version::getMajor public function
Version::getMinor public function
Version::getOriginalString public function
Version::getPatch public function
Version::getPreReleaseSuffix public function
Version::getVersionString public function
Version::hasBuildMetaData public function @psalm-assert-if-true BuildMetaData $this-&gt;buildMetadata
@psalm-assert-if-true BuildMetaData $this-&gt;getBuildMetaData()
Version::hasPreReleaseSuffix public function
Version::isGreaterThan public function
Version::parseVersion private function
Version::__construct public function

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal