Viewing file:  PhpVersion.php (4.47 KB) -rw-r--r--
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
<?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, 3);
}
/**
* 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;
}
}
|