165 lines
		
	
	
		
			4.5 KiB
		
	
	
	
		
			PHP
		
	
	
			
		
		
	
	
			165 lines
		
	
	
		
			4.5 KiB
		
	
	
	
		
			PHP
		
	
	
<?php declare(strict_types=1);
 | 
						|
 | 
						|
namespace PhpParser;
 | 
						|
 | 
						|
/**
 | 
						|
 * A PHP version, representing only the major and minor version components.
 | 
						|
 */
 | 
						|
class PhpVersion {
 | 
						|
    /** @var int Version ID in PHP_VERSION_ID format */
 | 
						|
    public int $id;
 | 
						|
 | 
						|
    /** @var int[] Minimum versions for builtin types */
 | 
						|
    private const BUILTIN_TYPE_VERSIONS = [
 | 
						|
        'array'    => 50100,
 | 
						|
        'callable' => 50400,
 | 
						|
        'bool'     => 70000,
 | 
						|
        'int'      => 70000,
 | 
						|
        'float'    => 70000,
 | 
						|
        'string'   => 70000,
 | 
						|
        'iterable' => 70100,
 | 
						|
        'void'     => 70100,
 | 
						|
        'object'   => 70200,
 | 
						|
        'null'     => 80000,
 | 
						|
        'false'    => 80000,
 | 
						|
        'mixed'    => 80000,
 | 
						|
        'never'    => 80100,
 | 
						|
        'true'     => 80200,
 | 
						|
    ];
 | 
						|
 | 
						|
    private function __construct(int $id) {
 | 
						|
        $this->id = $id;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Create a PhpVersion object from major and minor version components.
 | 
						|
     */
 | 
						|
    public static function fromComponents(int $major, int $minor): self {
 | 
						|
        return new self($major * 10000 + $minor * 100);
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Get the newest PHP version supported by this library. Support for this version may be partial,
 | 
						|
     * if it is still under development.
 | 
						|
     */
 | 
						|
    public static function getNewestSupported(): self {
 | 
						|
        return self::fromComponents(8, 4);
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Get the host PHP version, that is the PHP version we're currently running on.
 | 
						|
     */
 | 
						|
    public static function getHostVersion(): self {
 | 
						|
        return self::fromComponents(\PHP_MAJOR_VERSION, \PHP_MINOR_VERSION);
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Parse the version from a string like "8.1".
 | 
						|
     */
 | 
						|
    public static function fromString(string $version): self {
 | 
						|
        if (!preg_match('/^(\d+)\.(\d+)/', $version, $matches)) {
 | 
						|
            throw new \LogicException("Invalid PHP version \"$version\"");
 | 
						|
        }
 | 
						|
        return self::fromComponents((int) $matches[1], (int) $matches[2]);
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Check whether two versions are the same.
 | 
						|
     */
 | 
						|
    public function equals(PhpVersion $other): bool {
 | 
						|
        return $this->id === $other->id;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Check whether this version is greater than or equal to the argument.
 | 
						|
     */
 | 
						|
    public function newerOrEqual(PhpVersion $other): bool {
 | 
						|
        return $this->id >= $other->id;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Check whether this version is older than the argument.
 | 
						|
     */
 | 
						|
    public function older(PhpVersion $other): bool {
 | 
						|
        return $this->id < $other->id;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Check whether this is the host PHP version.
 | 
						|
     */
 | 
						|
    public function isHostVersion(): bool {
 | 
						|
        return $this->equals(self::getHostVersion());
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Check whether this PHP version supports the given builtin type. Type name must be lowercase.
 | 
						|
     */
 | 
						|
    public function supportsBuiltinType(string $type): bool {
 | 
						|
        $minVersion = self::BUILTIN_TYPE_VERSIONS[$type] ?? null;
 | 
						|
        return $minVersion !== null && $this->id >= $minVersion;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Whether this version supports [] array literals.
 | 
						|
     */
 | 
						|
    public function supportsShortArraySyntax(): bool {
 | 
						|
        return $this->id >= 50400;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Whether this version supports [] for destructuring.
 | 
						|
     */
 | 
						|
    public function supportsShortArrayDestructuring(): bool {
 | 
						|
        return $this->id >= 70100;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Whether this version supports flexible heredoc/nowdoc.
 | 
						|
     */
 | 
						|
    public function supportsFlexibleHeredoc(): bool {
 | 
						|
        return $this->id >= 70300;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Whether this version supports trailing commas in parameter lists.
 | 
						|
     */
 | 
						|
    public function supportsTrailingCommaInParamList(): bool {
 | 
						|
        return $this->id >= 80000;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Whether this version allows "$var =& new Obj".
 | 
						|
     */
 | 
						|
    public function allowsAssignNewByReference(): bool {
 | 
						|
        return $this->id < 70000;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Whether this version allows invalid octals like "08".
 | 
						|
     */
 | 
						|
    public function allowsInvalidOctals(): bool {
 | 
						|
        return $this->id < 70000;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Whether this version allows DEL (\x7f) to occur in identifiers.
 | 
						|
     */
 | 
						|
    public function allowsDelInIdentifiers(): bool {
 | 
						|
        return $this->id < 70100;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Whether this version supports yield in expression context without parentheses.
 | 
						|
     */
 | 
						|
    public function supportsYieldWithoutParentheses(): bool {
 | 
						|
        return $this->id >= 70000;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Whether this version supports unicode escape sequences in strings.
 | 
						|
     */
 | 
						|
    public function supportsUnicodeEscapes(): bool {
 | 
						|
        return $this->id >= 70000;
 | 
						|
    }
 | 
						|
}
 |