[DowngradePhp54] Add DowngradeThisInClosureRector (#1995)

build/target-repository/docs/rector_rules_overview.md

@@ -1,4 +1,4 @@
-# 506 Rules Overview
+# 508 Rules Overview
 
 <br>
 
@@ -20,7 +20,7 @@
 
 - [DowngradePhp53](#downgradephp53) (1)
 
-- [DowngradePhp54](#downgradephp54) (6)
+- [DowngradePhp54](#downgradephp54) (7)
 
 - [DowngradePhp55](#downgradephp55) (4)
 
@@ -38,7 +38,7 @@
 
 - [DowngradePhp80](#downgradephp80) (28)
 
-- [DowngradePhp81](#downgradephp81) (8)
+- [DowngradePhp81](#downgradephp81) (9)
 
 - [EarlyReturn](#earlyreturn) (11)
 
@@ -3916,6 +3916,33 @@ Remove static from closure
 
 <br>
 
+### DowngradeThisInClosureRector
+
+Downgrade `$this->` inside Closure to use assigned `$self` = `$this` before Closure
+
+- class: [`Rector\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector`](../rules/DowngradePhp54/Rector/Closure/DowngradeThisInClosureRector.php)
+
+```diff
+ class SomeClass
+ {
+     public $property = 'test';
+
+     public function run()
+     {
+-        $function = function () {
+-            echo $this->property;
++        $self = $this;
++        $function = function () use ($self) {
++            echo $self->property;
+         };
+
+         $function();
+     }
+ }
+```
+
+<br>
+
 ### ShortArrayToLongArrayRector
 
 Replace short arrays by long arrays
@@ -5826,6 +5853,35 @@ Removes union type property type definition, adding `@var` annotations instead.
 
 ## DowngradePhp81
 
+### DowngradeArrayIsListRector
+
+Replace `array_is_list()` function
+
+- class: [`Rector\DowngradePhp81\Rector\FuncCall\DowngradeArrayIsListRector`](../rules/DowngradePhp81/Rector/FuncCall/DowngradeArrayIsListRector.php)
+
+```diff
+-array_is_list([1 => 'apple', 'orange']);
++$arrayIsList = function (array $array) : bool {
++    if (function_exists('array_is_list')) {
++        return array_is_list($array);
++    }
++    if ($array === []) {
++        return true;
++    }
++    $current_key = 0;
++    foreach ($array as $key => $noop) {
++        if ($key !== $current_key) {
++            return false;
++        }
++        ++$current_key;
++    }
++    return true;
++};
++$arrayIsList([1 => 'apple', 'orange']);
+```
+
+<br>
+
 ### DowngradeArraySpreadStringKeyRector
 
 Replace array spread with string key to array_merge function

config/set/downgrade-php54.php

@@ -6,6 +6,7 @@
 use Rector\Core\ValueObject\PhpVersion;
 use Rector\DowngradePhp54\Rector\Array_\ShortArrayToLongArrayRector;
 use Rector\DowngradePhp54\Rector\Closure\DowngradeStaticClosureRector;
+use Rector\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector;
 use Rector\DowngradePhp54\Rector\FuncCall\DowngradeIndirectCallByArrayRector;
 use Rector\DowngradePhp54\Rector\FunctionLike\DowngradeCallableTypeDeclarationRector;
 use Rector\DowngradePhp54\Rector\LNumber\DowngradeBinaryNotationRector;
@@ -23,4 +24,5 @@
     $services->set(DowngradeCallableTypeDeclarationRector::class);
     $services->set(DowngradeBinaryNotationRector::class);
     $services->set(DowngradeInstanceMethodCallRector::class);
+    $services->set(DowngradeThisInClosureRector::class);
 };

rules-tests/DowngradePhp54/Rector/Closure/DowngradeThisInClosureRector/DowngradeThisInClosureRectorTest.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Rector\Tests\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector;
+
+use Iterator;
+use Rector\Testing\PHPUnit\AbstractRectorTestCase;
+use Symplify\SmartFileSystem\SmartFileInfo;
+
+final class DowngradeThisInClosureRectorTest extends AbstractRectorTestCase
+{
+    /**
+     * @dataProvider provideData()
+     */
+    public function test(SmartFileInfo $fileInfo): void
+    {
+        $this->doTestFileInfo($fileInfo);
+    }
+
+    /**
+     * @return Iterator<SmartFileInfo>
+     */
+    public function provideData(): Iterator
+    {
+        return $this->yieldFilesFromDirectory(__DIR__ . '/Fixture');
+    }
+
+    public function provideConfigFilePath(): string
+    {
+        return __DIR__ . '/config/configured_rule.php';
+    }
+}

rules-tests/DowngradePhp54/Rector/Closure/DowngradeThisInClosureRector/Fixture/deep_closure.php.inc

@@ -0,0 +1,46 @@
+<?php
+
+namespace Rector\Tests\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector\Fixture;
+
+class DeepClosure
+{
+    public $property = 'test';
+
+    public function run()
+    {
+        $function = function () {
+            $f = function () {
+                echo $this->property;
+            };
+            $f();
+        };
+
+        $function();
+    }
+}
+
+?>
+-----
+<?php
+
+namespace Rector\Tests\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector\Fixture;
+
+class DeepClosure
+{
+    public $property = 'test';
+
+    public function run()
+    {
+        $self = $this;
+        $function = function () use($self) {
+            $f = function () use($self) {
+                echo $self->property;
+            };
+            $f();
+        };
+
+        $function();
+    }
+}
+
+?>

rules-tests/DowngradePhp54/Rector/Closure/DowngradeThisInClosureRector/Fixture/fixture.php.inc

@@ -0,0 +1,40 @@
+<?php
+
+namespace Rector\Tests\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector\Fixture;
+
+class Fixture
+{
+    public $property = 'test';
+
+    public function run()
+    {
+        $function = function () {
+            echo $this->property;
+        };
+
+        $function();
+    }
+}
+
+?>
+-----
+<?php
+
+namespace Rector\Tests\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector\Fixture;
+
+class Fixture
+{
+    public $property = 'test';
+
+    public function run()
+    {
+        $self = $this;
+        $function = function () use($self) {
+            echo $self->property;
+        };
+
+        $function();
+    }
+}
+
+?>

rules-tests/DowngradePhp54/Rector/Closure/DowngradeThisInClosureRector/Fixture/self_variable_exists.php.inc

@@ -0,0 +1,42 @@
+<?php
+
+namespace Rector\Tests\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector\Fixture;
+
+class SelfVariableExists
+{
+    public $property = 'test';
+
+    public function run()
+    {
+        $self = 'test';
+        $function = function () {
+            echo $this->property;
+        };
+
+        $function();
+    }
+}
+
+?>
+-----
+<?php
+
+namespace Rector\Tests\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector\Fixture;
+
+class SelfVariableExists
+{
+    public $property = 'test';
+
+    public function run()
+    {
+        $self = 'test';
+        $self2 = $this;
+        $function = function () use($self2) {
+            echo $self2->property;
+        };
+
+        $function();
+    }
+}
+
+?>

rules-tests/DowngradePhp54/Rector/Closure/DowngradeThisInClosureRector/Fixture/skip_in_anonymous_class.php.inc

@@ -0,0 +1,22 @@
+<?php
+
+namespace Rector\Tests\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector\Fixture;
+
+class SkipInAnonymousClass
+{
+    public $property = 'test';
+
+    public function run()
+    {
+        $function = function () {
+            new class {
+                public function test()
+                {
+                    echo $this->property;
+                }
+            };
+        };
+
+        $function();
+    }
+}

rules-tests/DowngradePhp54/Rector/Closure/DowngradeThisInClosureRector/Fixture/skip_private_property.php.inc

@@ -0,0 +1,17 @@
+<?php
+
+namespace Rector\Tests\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector\Fixture;
+
+class SkipPrivateProperty
+{
+    private $property = 'test';
+
+    public function run()
+    {
+        $function = function () {
+            echo $this->property;
+        };
+
+        $function();
+    }
+}

rules-tests/DowngradePhp54/Rector/Closure/DowngradeThisInClosureRector/config/configured_rule.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\DowngradePhp54\Rector\Closure\DowngradeThisInClosureRector;
+use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+return static function (ContainerConfigurator $containerConfigurator): void {
+    $services = $containerConfigurator->services();
+    $services->set(DowngradeThisInClosureRector::class);
+};