PhpVersion.php

<?php declare(strict_types = 1);

namespace PHPStan\Php;

use function floor;

/** @api */
class PhpVersion
{

	public function __construct(private int $versionId)
	{
	}

	public function getVersionId(): int
	{
		return $this->versionId;
	}

	public function getVersionString(): string
	{
		$first = (int) floor($this->versionId / 10000);
		$second = (int) floor(($this->versionId % 10000) / 100);
		$third = (int) floor($this->versionId % 100);

		return $first . '.' . $second . ($third !== 0 ? '.' . $third : '');
	}

	public function supportsNullCoalesceAssign(): bool
	{
		return $this->versionId >= 70400;
	}

	public function supportsParameterContravariance(): bool
	{
		return $this->versionId >= 70400;
	}

	public function supportsReturnCovariance(): bool
	{
		return $this->versionId >= 70400;
	}

	public function supportsNoncapturingCatches(): bool
	{
		return $this->versionId >= 80000;
	}

	public function supportsNativeUnionTypes(): bool
	{
		return $this->versionId >= 80000;
	}

	public function deprecatesRequiredParameterAfterOptional(): bool
	{
		return $this->versionId >= 80000;
	}

	public function deprecatesRequiredParameterAfterOptionalNullableAndDefaultNull(): bool
	{
		return $this->versionId >= 80100;
	}

	public function deprecatesRequiredParameterAfterOptionalUnionOrMixed(): bool
	{
		return $this->versionId >= 80300;
	}

	public function supportsLessOverridenParametersWithVariadic(): bool
	{
		return $this->versionId >= 80000;
	}

	public function supportsThrowExpression(): bool
	{
		return $this->versionId >= 80000;
	}

	public function supportsClassConstantOnExpression(): bool
	{
		return $this->versionId >= 80000;
	}

	public function supportsLegacyConstructor(): bool
	{
		return $this->versionId < 80000;
	}

	public function supportsPromotedProperties(): bool
	{
		return $this->versionId >= 80000;
	}

	public function supportsParameterTypeWidening(): bool
	{
		return $this->versionId >= 70200;
	}

	public function supportsUnsetCast(): bool
	{
		return $this->versionId < 80000;
	}

	public function supportsNamedArguments(): bool
	{
		return $this->versionId >= 80000;
	}

	public function throwsTypeErrorForInternalFunctions(): bool
	{
		return $this->versionId >= 80000;
	}

	public function throwsValueErrorForInternalFunctions(): bool
	{
		return $this->versionId >= 80000;
	}

	public function supportsHhPrintfSpecifier(): bool
	{
		return $this->versionId >= 80000;
	}

	public function isEmptyStringValidAliasForNoneInMbSubstituteCharacter(): bool
	{
		return $this->versionId < 80000;
	}

	public function supportsAllUnicodeScalarCodePointsInMbSubstituteCharacter(): bool
	{
		return $this->versionId >= 70200;
	}

	public function isNumericStringValidArgInMbSubstituteCharacter(): bool
	{
		return $this->versionId < 80000;
	}

	public function isNullValidArgInMbSubstituteCharacter(): bool
	{
		return $this->versionId >= 80000;
	}

	public function isInterfaceConstantImplicitlyFinal(): bool
	{
		return $this->versionId < 80100;
	}

	public function supportsFinalConstants(): bool
	{
		return $this->versionId >= 80100;
	}

	public function supportsReadOnlyProperties(): bool
	{
		return $this->versionId >= 80100;
	}

	public function supportsEnums(): bool
	{
		return $this->versionId >= 80100;
	}

	public function supportsPureIntersectionTypes(): bool
	{
		return $this->versionId >= 80100;
	}

	public function supportsCaseInsensitiveConstantNames(): bool
	{
		return $this->versionId < 80000;
	}

	public function hasStricterRoundFunctions(): bool
	{
		return $this->versionId >= 80000;
	}

	public function hasTentativeReturnTypes(): bool
	{
		return $this->versionId >= 80100;
	}

	public function supportsFirstClassCallables(): bool
	{
		return $this->versionId >= 80100;
	}

	public function supportsArrayUnpackingWithStringKeys(): bool
	{
		return $this->versionId >= 80100;
	}

	public function throwsOnInvalidMbStringEncoding(): bool
	{
		return $this->versionId >= 80000;
	}

	public function supportsPassNoneEncodings(): bool
	{
		return $this->versionId < 70300;
	}

	public function producesWarningForFinalPrivateMethods(): bool
	{
		return $this->versionId >= 80000;
	}

	public function deprecatesDynamicProperties(): bool
	{
		return $this->versionId >= 80200;
	}

	public function strSplitReturnsEmptyArray(): bool
	{
		return $this->versionId >= 80200;
	}

	public function supportsDisjunctiveNormalForm(): bool
	{
		return $this->versionId >= 80200;
	}

	public function serializableRequiresMagicMethods(): bool
	{
		return $this->versionId >= 80100;
	}

	public function arrayFunctionsReturnNullWithNonArray(): bool
	{
		return $this->versionId < 80000;
	}

	// see https://www.php.net/manual/en/migration80.incompatible.php#migration80.incompatible.core.string-number-comparision
	public function castsNumbersToStringsOnLooseComparison(): bool
	{
		return $this->versionId >= 80000;
	}

	public function supportsCallableInstanceMethods(): bool
	{
		return $this->versionId < 80000;
	}

	public function supportsJsonValidate(): bool
	{
		return $this->versionId >= 80300;
	}

	public function supportsConstantsInTraits(): bool
	{
		return $this->versionId >= 80200;
	}

	public function supportsNativeTypesInClassConstants(): bool
	{
		return $this->versionId >= 80300;
	}

	public function supportsAbstractTraitMethods(): bool
	{
		return $this->versionId >= 80000;
	}

	public function supportsOverrideAttribute(): bool
	{
		return $this->versionId >= 80300;
	}

	public function supportsDynamicClassConstantFetch(): bool
	{
		return $this->versionId >= 80300;
	}

	public function supportsReadOnlyClasses(): bool
	{
		return $this->versionId >= 80200;
	}

	public function supportsReadOnlyAnonymousClasses(): bool
	{
		return $this->versionId >= 80300;
	}

	public function supportsNeverReturnTypeInArrowFunction(): bool
	{
		return $this->versionId >= 80200;
	}

	// see https://www.php.net/manual/en/migration74.incompatible.php#migration74.incompatible.pcre
	public function returnsPregUnmatchedCapturingGroups(): bool
	{
		// When PREG_UNMATCHED_AS_NULL mode is used, trailing unmatched capturing groups will now also be set to null (or [null, -1] if offset capture is enabled).
		// This means that the size of the $matches will always be the same.
		return $this->versionId >= 70400;
	}

}