[DX] Check php version features parameter type (#983)

src/Php/PhpVersionProvider.php

@@ -4,8 +4,11 @@ declare(strict_types=1);
 
 namespace Rector\Core\Php;
 
+use Nette\Utils\Strings;
 use Rector\Core\Configuration\Option;
+use Rector\Core\Exception\Configuration\InvalidConfigurationException;
 use Rector\Core\Php\PhpVersionResolver\ProjectComposerJsonPhpVersionResolver;
+use Rector\Core\ValueObject\PhpVersion;
 use Rector\Testing\PHPUnit\StaticPHPUnitEnvironment;
 use Symplify\PackageBuilder\Parameter\ParameterProvider;
 
@@ -14,6 +17,12 @@ use Symplify\PackageBuilder\Parameter\ParameterProvider;
  */
 final class PhpVersionProvider
 {
+    /**
+     * @var string
+     * @see https://regex101.com/r/qBMnbl/1
+     */
+    private const VALID_PHP_VERSION_REGEX = '#^\d{5,6}$#';
+
     public function __construct(
         private ParameterProvider $parameterProvider,
         private ProjectComposerJsonPhpVersionResolver $projectComposerJsonPhpVersionResolver
@@ -22,15 +31,17 @@ final class PhpVersionProvider
 
     public function provide(): int
     {
-        $phpVersionFeatures = $this->parameterProvider->provideIntParameter(Option::PHP_VERSION_FEATURES);
+        $phpVersionFeatures = $this->parameterProvider->provideParameter(Option::PHP_VERSION_FEATURES);
+        $this->validatePhpVersionFeaturesParameter($phpVersionFeatures);
+
         if ($phpVersionFeatures > 0) {
             return $phpVersionFeatures;
         }
 
         // for tests
         if (StaticPHPUnitEnvironment::isPHPUnitRun()) {
-            // so we don't have to up
-            return 100000;
+            // so we don't have to keep with up with newest version
+            return PhpVersion::PHP_10;
         }
 
         $projectComposerJson = getcwd() . '/composer.json';
@@ -48,4 +59,43 @@ final class PhpVersionProvider
     {
         return $phpVersion <= $this->provide();
     }
+
+    private function validatePhpVersionFeaturesParameter(mixed $phpVersionFeatures): void
+    {
+        if ($phpVersionFeatures === null) {
+            return;
+        }
+
+        if (PhpVersion::isValid($phpVersionFeatures)) {
+            return;
+        }
+
+        if (! is_int($phpVersionFeatures)) {
+            $this->throwInvalidTypeException($phpVersionFeatures);
+        }
+
+        if (Strings::match(
+            (string) $phpVersionFeatures,
+            self::VALID_PHP_VERSION_REGEX
+        ) && $phpVersionFeatures >= (PhpVersion::PHP_53 - 1)) {
+            return;
+        }
+
+        $this->throwInvalidTypeException($phpVersionFeatures);
+    }
+
+    private function throwInvalidTypeException(mixed $phpVersionFeatures): void
+    {
+        $errorMessage = sprintf(
+            'Parameter "%s::%s" must be int, "%s" given.%sUse constant from "%s" to provide it, e.g. "%s::%s"',
+            Option::class,
+            'PHP_VERSION_FEATURES',
+            (string) $phpVersionFeatures,
+            PHP_EOL,
+            PhpVersion::class,
+            PhpVersion::class,
+            'PHP_80'
+        );
+        throw new InvalidConfigurationException($errorMessage);
+    }
 }

src/ValueObject/PhpVersion.php

@@ -4,7 +4,9 @@ declare(strict_types=1);
 
 namespace Rector\Core\ValueObject;
 
-final class PhpVersion
+use MyCLabs\Enum\Enum;
+
+final class PhpVersion extends Enum
 {
     /**
      * @api

templates/rector.php.dist

@@ -15,7 +15,7 @@ return static function (ContainerConfigurator $containerConfigurator): void {
     ]);
 
     // Define what rule sets will be applied
-    $containerConfigurator->import(SetList::CODE_QUALITY);
+    $containerConfigurator->import(SetList::DEAD_CODE);
 
     // get services (needed for register a single rule)
     // $services = $containerConfigurator->services();

tests/Php/PhpVersionProviderTest.php

@@ -4,22 +4,56 @@ declare(strict_types=1);
 
 namespace Rector\Core\Tests\Php;
 
+use Iterator;
+use Rector\Core\Exception\Configuration\InvalidConfigurationException;
 use Rector\Core\Php\PhpVersionProvider;
 use Rector\Testing\PHPUnit\AbstractTestCase;
+use Symplify\SmartFileSystem\SmartFileInfo;
 
 final class PhpVersionProviderTest extends AbstractTestCase
 {
-    private PhpVersionProvider $phpVersionProvider;
-
-    protected function setUp(): void
+    /**
+     * @doesNotPerformAssertions
+     * @dataProvider provideValidConfigData()
+     */
+    public function testValidInput(SmartFileInfo $invalidFileInfo): void
     {
-        $this->boot();
-        $this->phpVersionProvider = $this->getService(PhpVersionProvider::class);
+        $this->bootFromConfigFileInfos([$invalidFileInfo]);
+
+        $phpVersionProvider = $this->getService(PhpVersionProvider::class);
+        $phpVersionProvider->provide();
     }
 
-    public function test(): void
+    /**
+     * @return Iterator<SmartFileInfo[]>
+     */
+    public function provideValidConfigData(): Iterator
     {
-        $phpVersion = $this->phpVersionProvider->provide();
-        $this->assertSame(100000, $phpVersion);
+        yield [new SmartFileInfo(__DIR__ . '/config/valid_explicit_value.php')];
+        yield [new SmartFileInfo(__DIR__ . '/config/valid_minus_value.php')];
+    }
+
+    /**
+     * @dataProvider provideInvalidConfigData()
+     */
+    public function testInvalidInput(SmartFileInfo $invalidFileInfo): void
+    {
+        $this->expectException(InvalidConfigurationException::class);
+
+        $this->bootFromConfigFileInfos([$invalidFileInfo]);
+
+        $phpVersionProvider = $this->getService(PhpVersionProvider::class);
+        $phpVersionProvider->provide();
+    }
+
+    /**
+     * @return Iterator<SmartFileInfo[]>
+     */
+    public function provideInvalidConfigData(): Iterator
+    {
+        yield [new SmartFileInfo(__DIR__ . '/config/invalid_input.php')];
+        yield [new SmartFileInfo(__DIR__ . '/config/invalid_string_input.php')];
+        yield [new SmartFileInfo(__DIR__ . '/config/invalid_number_input.php')];
+        yield [new SmartFileInfo(__DIR__ . '/config/invalid_php_4_number.php')];
     }
 }

tests/Php/config/invalid_input.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Core\Configuration\Option;
+use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+return static function (ContainerConfigurator $containerConfigurator): void {
+    $parameters = $containerConfigurator->parameters();
+    $parameters->set(Option::PHP_VERSION_FEATURES, '10000');
+};

tests/Php/config/invalid_number_input.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Core\Configuration\Option;
+use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+return static function (ContainerConfigurator $containerConfigurator): void {
+    $parameters = $containerConfigurator->parameters();
+    $parameters->set(Option::PHP_VERSION_FEATURES, 291_084_902_184);
+};

tests/Php/config/invalid_php_4_number.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Core\Configuration\Option;
+use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+return static function (ContainerConfigurator $containerConfigurator): void {
+    $parameters = $containerConfigurator->parameters();
+    $parameters->set(Option::PHP_VERSION_FEATURES, 40000);
+};

tests/Php/config/invalid_string_input.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Core\Configuration\Option;
+use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+return static function (ContainerConfigurator $containerConfigurator): void {
+    $parameters = $containerConfigurator->parameters();
+    $parameters->set(Option::PHP_VERSION_FEATURES, '7.3');
+};

tests/Php/config/valid_explicit_value.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Core\Configuration\Option;
+use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+return static function (ContainerConfigurator $containerConfigurator): void {
+    $parameters = $containerConfigurator->parameters();
+    $parameters->set(Option::PHP_VERSION_FEATURES, 100000);
+};

tests/Php/config/valid_minus_value.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Core\Configuration\Option;
+use Rector\Core\ValueObject\PhpVersionFeature;
+use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+return static function (ContainerConfigurator $containerConfigurator): void {
+    $parameters = $containerConfigurator->parameters();
+    $parameters->set(Option::PHP_VERSION_FEATURES, PhpVersionFeature::ARRAY_KEY_FIRST_LAST - 1);
+};