mirror of https://github.com/rectorphp/rector.git synced 2025-01-19 14:27:14 +01:00

Co-authored-by: rector-bot <tomas@getrector.org>

2021-01-27 15:09:08 +01:00

359 KiB

Raw Blame History

668 Rules Overview

Architecture

ReplaceParentRepositoryCallsByRepositoryPropertyRector

Handles method calls in child of Doctrine EntityRepository and moves them to $this->repository property.

class: Rector\Architecture\Rector\MethodCall\ReplaceParentRepositoryCallsByRepositoryPropertyRector

 use Doctrine\ORM\EntityRepository;

 class SomeRepository extends EntityRepository
 {
     public function someMethod()
     {
-        return $this->findAll();
+        return $this->repository->findAll();
     }
 }

ServiceLocatorToDIRector

Turns $this->getRepository() in Symfony Controller to constructor injection and private property access.

class: Rector\Architecture\Rector\MethodCall\ServiceLocatorToDIRector

 class ProductController extends Controller
 {
+    /**
+     * @var ProductRepository
+     */
+    private $productRepository;
+
+    public function __construct(ProductRepository $productRepository)
+    {
+        $this->productRepository = $productRepository;
+    }
+
     public function someAction()
     {
         $entityManager = $this->getDoctrine()->getManager();
-        $entityManager->getRepository('SomethingBundle:Product')->findSomething(...);
+        $this->productRepository->findSomething(...);
     }
 }

Autodiscovery

MoveEntitiesToEntityDirectoryRector

Move entities to Entity namespace

class: Rector\Autodiscovery\Rector\FileNode\MoveEntitiesToEntityDirectoryRector

-// file: app/Controller/Product.php
+// file: app/Entity/Product.php

-namespace App\Controller;
+namespace App\Entity;

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class Product
 {
 }

MoveInterfacesToContractNamespaceDirectoryRector

Move interface to "Contract" namespace

class: Rector\Autodiscovery\Rector\FileNode\MoveInterfacesToContractNamespaceDirectoryRector

-// file: app/Exception/Rule.php
+// file: app/Contract/Rule.php

-namespace App\Exception;
+namespace App\Contract;

 interface Rule
 {
 }

MoveServicesBySuffixToDirectoryRector

Move classes by their suffix to their own group/directory

🔧 configure it!

class: Rector\Autodiscovery\Rector\FileNode\MoveServicesBySuffixToDirectoryRector

use Rector\Autodiscovery\Rector\FileNode\MoveServicesBySuffixToDirectoryRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(MoveServicesBySuffixToDirectoryRector::class)
        ->call('configure', [[
            MoveServicesBySuffixToDirectoryRector::GROUP_NAMES_BY_SUFFIX => ['Repository'],
        ]]);
};

↓

-// file: app/Entity/ProductRepository.php
+// file: app/Repository/ProductRepository.php

-namespace App/Entity;
+namespace App/Repository;

 class ProductRepository
 {
 }

MoveValueObjectsToValueObjectDirectoryRector

Move value object to ValueObject namespace/directory

🔧 configure it!

class: Rector\Autodiscovery\Rector\FileNode\MoveValueObjectsToValueObjectDirectoryRector

use Rector\Autodiscovery\Rector\FileNode\MoveValueObjectsToValueObjectDirectoryRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(MoveValueObjectsToValueObjectDirectoryRector::class)
        ->call('configure', [[
            MoveValueObjectsToValueObjectDirectoryRector::TYPES => ['ValueObjectInterfaceClassName'],
            MoveValueObjectsToValueObjectDirectoryRector::SUFFIXES => ['Search'],
            MoveValueObjectsToValueObjectDirectoryRector::ENABLE_VALUE_OBJECT_GUESSING => true,
        ]]);
};

↓

-// app/Exception/Name.php
+// app/ValueObject/Name.php
 class Name
 {
     private $name;

     public function __construct(string $name)
     {
         $this->name = $name;
     }

     public function getName()
     {
         return $this->name;
     }
 }

CakePHP

AppUsesStaticCallToUseStatementRector

Change App::uses() to use imports

class: Rector\CakePHP\Rector\Namespace_\AppUsesStaticCallToUseStatementRector

-App::uses('NotificationListener', 'Event');
+use Event\NotificationListener;

 CakeEventManager::instance()->attach(new NotificationListener());

ArrayToFluentCallRector

Moves array options to fluent setter method calls.

🔧 configure it!

class: Rector\CakePHP\Rector\MethodCall\ArrayToFluentCallRector

use Rector\CakePHP\Rector\MethodCall\ArrayToFluentCallRector;
use Rector\CakePHP\ValueObject\ArrayToFluentCall;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ArrayToFluentCallRector::class)
        ->call('configure', [[
            ArrayToFluentCallRector::ARRAYS_TO_FLUENT_CALLS => ValueObjectInliner::inline([
                new ArrayToFluentCall('ArticlesTable', ['setForeignKey', 'setProperty']), ]
            ),
        ]]);
};

↓

 use Cake\ORM\Table;

 final class ArticlesTable extends Table
 {
     public function initialize(array $config)
     {
-        $this->belongsTo('Authors', [
-            'foreignKey' => 'author_id',
-            'propertyName' => 'person'
-        ]);
+        $this->belongsTo('Authors')
+            ->setForeignKey('author_id')
+            ->setProperty('person');
     }
 }

ChangeSnakedFixtureNameToPascalRector

Changes $fixtues style from snake_case to PascalCase.

class: Rector\CakePHP\Rector\Property\ChangeSnakedFixtureNameToPascalRector

 class SomeTest
 {
     protected $fixtures = [
-        'app.posts',
-        'app.users',
-        'some_plugin.posts/special_posts',
+        'app.Posts',
+        'app.Users',
+        'some_plugin.Posts/SpecialPosts',
     ];

ImplicitShortClassNameUseStatementRector

Collect implicit class names and add imports

class: Rector\CakePHP\Rector\FileWithoutNamespace\ImplicitShortClassNameUseStatementRector

 use App\Foo\Plugin;
+use Cake\TestSuite\Fixture\TestFixture;

 class LocationsFixture extends TestFixture implements Plugin
 {
 }

ModalToGetSetRector

Changes combined set/get value() to specific getValue() or setValue(x).

🔧 configure it!

class: Rector\CakePHP\Rector\MethodCall\ModalToGetSetRector

use Rector\CakePHP\Rector\MethodCall\ModalToGetSetRector;
use Rector\CakePHP\ValueObject\ModalToGetSet;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ModalToGetSetRector::class)
        ->call('configure', [[
            ModalToGetSetRector::UNPREFIXED_METHODS_TO_GET_SET => ValueObjectInliner::inline([
                new ModalToGetSet('InstanceConfigTrait', 'config', 'getConfig', 'setConfig', 1, null),
            ]),
        ]]);
};

↓

 $object = new InstanceConfigTrait;

-$config = $object->config();
-$config = $object->config('key');
+$config = $object->getConfig();
+$config = $object->getConfig('key');

-$object->config('key', 'value');
-$object->config(['key' => 'value']);
+$object->setConfig('key', 'value');
+$object->setConfig(['key' => 'value']);

RenameMethodCallBasedOnParameterRector

Changes method calls based on matching the first parameter value.

🔧 configure it!

class: Rector\CakePHP\Rector\MethodCall\RenameMethodCallBasedOnParameterRector

use Rector\CakePHP\Rector\MethodCall\RenameMethodCallBasedOnParameterRector;
use Rector\CakePHP\ValueObject\RenameMethodCallBasedOnParameter;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(RenameMethodCallBasedOnParameterRector::class)
        ->call('configure', [[
            RenameMethodCallBasedOnParameterRector::CALLS_WITH_PARAM_RENAMES => ValueObjectInliner::inline([
                new RenameMethodCallBasedOnParameter('getParam', 'paging', 'getAttribute', 'ServerRequest'),
                new RenameMethodCallBasedOnParameter('withParam', 'paging', 'withAttribute', 'ServerRequest'),
            ]),
        ]]);
};

↓

 $object = new ServerRequest();

-$config = $object->getParam('paging');
-$object = $object->withParam('paging', ['a value']);
+$config = $object->getAttribute('paging');
+$object = $object->withAttribute('paging', ['a value']);

Carbon

ChangeCarbonSingularMethodCallToPluralRector

Change setter methods with args to their plural names on Carbon\Carbon

class: Rector\Carbon\Rector\MethodCall\ChangeCarbonSingularMethodCallToPluralRector

 use Carbon\Carbon;

 final class SomeClass
 {
     public function run(Carbon $carbon, $value): void
     {
-        $carbon->addMinute($value);
+        $carbon->addMinutes($value);
     }
 }

ChangeDiffForHumansArgsRector

Change methods arguments of diffForHumans() on Carbon\Carbon

class: Rector\Carbon\Rector\MethodCall\ChangeDiffForHumansArgsRector

 use Carbon\Carbon;

 final class SomeClass
 {
     public function run(Carbon $carbon): void
     {
-        $carbon->diffForHumans(null, true);
+        $carbon->diffForHumans(null, \Carbon\CarbonInterface::DIFF_ABSOLUTE);

-        $carbon->diffForHumans(null, false);
+        $carbon->diffForHumans(null, \Carbon\CarbonInterface::DIFF_RELATIVE_AUTO);
     }
 }

CodeQuality

AbsolutizeRequireAndIncludePathRector

include/require to absolute path. This Rector might introduce backwards incompatible code, when the include/require beeing changed depends on the current working directory.

class: Rector\CodeQuality\Rector\Include_\AbsolutizeRequireAndIncludePathRector

 class SomeClass
 {
     public function run()
     {
-        require 'autoload.php';
+        require __DIR__ . '/autoload.php';

         require $variable;
     }
 }

AddPregQuoteDelimiterRector

Add preg_quote delimiter when missing

class: Rector\CodeQuality\Rector\FuncCall\AddPregQuoteDelimiterRector

-'#' . preg_quote('name') . '#';
+'#' . preg_quote('name', '#') . '#';

AndAssignsToSeparateLinesRector

Split 2 assigns ands to separate line

class: Rector\CodeQuality\Rector\LogicalAnd\AndAssignsToSeparateLinesRector

 class SomeClass
 {
     public function run()
     {
         $tokens = [];
-        $token = 4 and $tokens[] = $token;
+        $token = 4;
+        $tokens[] = $token;
     }
 }

ArrayKeyExistsTernaryThenValueToCoalescingRector

Change array_key_exists() ternary to coalesing

class: Rector\CodeQuality\Rector\Ternary\ArrayKeyExistsTernaryThenValueToCoalescingRector

 class SomeClass
 {
     public function run($values, $keyToMatch)
     {
-        $result = array_key_exists($keyToMatch, $values) ? $values[$keyToMatch] : null;
+        $result = $values[$keyToMatch] ?? null;
     }
 }

ArrayKeysAndInArrayToArrayKeyExistsRector

Replace array_keys() and in_array() to array_key_exists()

class: Rector\CodeQuality\Rector\FuncCall\ArrayKeysAndInArrayToArrayKeyExistsRector

 class SomeClass
 {
     public function run($packageName, $values)
     {
-        $keys = array_keys($values);
-        return in_array($packageName, $keys, true);
+        return array_key_exists($packageName, $values);
     }
 }

ArrayMergeOfNonArraysToSimpleArrayRector

Change array_merge of non arrays to array directly

class: Rector\CodeQuality\Rector\FuncCall\ArrayMergeOfNonArraysToSimpleArrayRector

 class SomeClass
 {
     public function go()
     {
         $value = 5;
         $value2 = 10;

-        return array_merge([$value], [$value2]);
+        return [$value, $value2];
     }
 }

ArrayThisCallToThisMethodCallRector

Change [$this, someMethod] without any args to $this->someMethod()

class: Rector\CodeQuality\Rector\Array_\ArrayThisCallToThisMethodCallRector

 class SomeClass
 {
     public function run()
     {
-        $values = [$this, 'giveMeMore'];
+        $values = $this->giveMeMore();
     }

     public function giveMeMore()
     {
         return 'more';
     }
 }

BooleanNotIdenticalToNotIdenticalRector

Negated identical boolean compare to not identical compare (does not apply to non-bool values)

class: Rector\CodeQuality\Rector\Identical\BooleanNotIdenticalToNotIdenticalRector

 class SomeClass
 {
     public function run()
     {
         $a = true;
         $b = false;

-        var_dump(! $a === $b); // true
-        var_dump(! ($a === $b)); // true
+        var_dump($a !== $b); // true
+        var_dump($a !== $b); // true
         var_dump($a !== $b); // true
     }
 }

CallableThisArrayToAnonymousFunctionRector

Convert [$this, "method"] to proper anonymous function

class: Rector\CodeQuality\Rector\Array_\CallableThisArrayToAnonymousFunctionRector

 class SomeClass
 {
     public function run()
     {
         $values = [1, 5, 3];
-        usort($values, [$this, 'compareSize']);
+        usort($values, function ($first, $second) {
+            return $this->compareSize($first, $second);
+        });

         return $values;
     }

     private function compareSize($first, $second)
     {
         return $first <=> $second;
     }
 }

ChangeArrayPushToArrayAssignRector

Change array_push() to direct variable assign

class: Rector\CodeQuality\Rector\FuncCall\ChangeArrayPushToArrayAssignRector

 class SomeClass
 {
     public function run()
     {
         $items = [];
-        array_push($items, $item);
+        $items[] = $item;
     }
 }

CombineIfRector

Merges nested if statements

class: Rector\CodeQuality\Rector\If_\CombineIfRector

 class SomeClass
 {
     public function run()
     {
-        if ($cond1) {
-            if ($cond2) {
-                return 'foo';
-            }
+        if ($cond1 && $cond2) {
+            return 'foo';
         }
     }
 }

CombinedAssignRector

Simplify $value = $value + 5; assignments to shorter ones

class: Rector\CodeQuality\Rector\Assign\CombinedAssignRector

-$value = $value + 5;
+$value += 5;

CommonNotEqualRector

Use common != instead of less known <> with same meaning

class: Rector\CodeQuality\Rector\NotEqual\CommonNotEqualRector

 final class SomeClass
 {
     public function run($one, $two)
     {
-        return $one <> $two;
+        return $one != $two;
     }
 }

CompactToVariablesRector

Change compact() call to own array

class: Rector\CodeQuality\Rector\FuncCall\CompactToVariablesRector

 class SomeClass
 {
     public function run()
     {
         $checkout = 'one';
         $form = 'two';

-        return compact('checkout', 'form');
+        return ['checkout' => $checkout, 'form' => $form];
     }
 }

CompleteDynamicPropertiesRector

Add missing dynamic properties

class: Rector\CodeQuality\Rector\Class_\CompleteDynamicPropertiesRector

 class SomeClass
 {
+    /**
+     * @var int
+     */
+    public $value;
     public function set()
     {
         $this->value = 5;
     }
 }

ConsecutiveNullCompareReturnsToNullCoalesceQueueRector

Change multiple null compares to ?? queue

class: Rector\CodeQuality\Rector\If_\ConsecutiveNullCompareReturnsToNullCoalesceQueueRector

 class SomeClass
 {
     public function run()
     {
-        if (null !== $this->orderItem) {
-            return $this->orderItem;
-        }
-
-        if (null !== $this->orderItemUnit) {
-            return $this->orderItemUnit;
-        }
-
-        return null;
+        return $this->orderItem ?? $this->orderItemUnit;
     }
 }

DateTimeToDateTimeInterfaceRector

Changes DateTime type-hint to DateTimeInterface

class: Rector\CodeQuality\Rector\ClassMethod\DateTimeToDateTimeInterfaceRector

 class SomeClass {
-    public function methodWithDateTime(\DateTime $dateTime)
+    /**
+     * @param \DateTime|\DateTimeImmutable $dateTime
+     */
+    public function methodWithDateTime(\DateTimeInterface $dateTime)
     {
         return true;
     }
 }

ExplicitBoolCompareRector

Make if conditions more explicit

class: Rector\CodeQuality\Rector\If_\ExplicitBoolCompareRector

 final class SomeController
 {
     public function run($items)
     {
-        if (!count($items)) {
+        if (count($items) === 0) {
             return 'no items';
         }
     }
 }

FixClassCaseSensitivityNameRector

Change miss-typed case sensitivity name to correct one

class: Rector\CodeQuality\Rector\Name\FixClassCaseSensitivityNameRector

 final class SomeClass
 {
     public function run()
     {
-        $anotherClass = new anotherclass;
+        $anotherClass = new AnotherClass;
     }
 }

 final class AnotherClass
 {
 }

FlipTypeControlToUseExclusiveTypeRector

Flip type control to use exclusive type

class: Rector\CodeQuality\Rector\Identical\FlipTypeControlToUseExclusiveTypeRector

 class SomeClass
 {
     public function __construct(array $values)
     {
-        /** @var PhpDocInfo|null $phpDocInfo */
         $phpDocInfo = $functionLike->getAttribute(AttributeKey::PHP_DOC_INFO);
-        if ($phpDocInfo === null) {
+        if (! $phpDocInfo instanceof PhpDocInfo) {
             return;
         }
     }
 }

ForRepeatedCountToOwnVariableRector

Change count() in for function to own variable

class: Rector\CodeQuality\Rector\For_\ForRepeatedCountToOwnVariableRector

 class SomeClass
 {
     public function run($items)
     {
-        for ($i = 5; $i <= count($items); $i++) {
+        $itemsCount = count($items);
+        for ($i = 5; $i <= $itemsCount; $i++) {
             echo $items[$i];
         }
     }
 }

ForToForeachRector

Change for() to foreach() where useful

class: Rector\CodeQuality\Rector\For_\ForToForeachRector

 class SomeClass
 {
     public function run($tokens)
     {
-        for ($i = 0, $c = count($tokens); $i < $c; ++$i) {
-            if ($tokens[$i][0] === T_STRING && $tokens[$i][1] === 'fn') {
+        foreach ($tokens as $i => $token) {
+            if ($token[0] === T_STRING && $token[1] === 'fn') {
                 $previousNonSpaceToken = $this->getPreviousNonSpaceToken($tokens, $i);
                 if ($previousNonSpaceToken !== null && $previousNonSpaceToken[0] === T_OBJECT_OPERATOR) {
                     continue;
                 }
                 $tokens[$i][0] = self::T_FN;
             }
         }
     }
 }

ForeachItemsAssignToEmptyArrayToAssignRector

Change foreach() items assign to empty array to direct assign

class: Rector\CodeQuality\Rector\Foreach_\ForeachItemsAssignToEmptyArrayToAssignRector

 class SomeClass
 {
     public function run($items)
     {
         $collectedItems = [];

-        foreach ($items as $item) {
-             $collectedItems[] = $item;
-        }
+        $collectedItems = $items;
     }
 }

ForeachToInArrayRector

Simplify foreach loops into in_array when possible

class: Rector\CodeQuality\Rector\Foreach_\ForeachToInArrayRector

-foreach ($items as $item) {
-    if ($item === 'something') {
-        return true;
-    }
-}
-
-return false;
+in_array("something", $items, true);

GetClassToInstanceOfRector

Changes comparison with get_class to instanceof

class: Rector\CodeQuality\Rector\Identical\GetClassToInstanceOfRector

-if (EventsListener::class === get_class($event->job)) { }
+if ($event->job instanceof EventsListener) { }

InArrayAndArrayKeysToArrayKeyExistsRector

Simplify in_array and array_keys functions combination into array_key_exists when array_keys has one argument only

class: Rector\CodeQuality\Rector\FuncCall\InArrayAndArrayKeysToArrayKeyExistsRector

-in_array("key", array_keys($array), true);
+array_key_exists("key", $array);

InlineIfToExplicitIfRector

Change inline if to explicit if

class: Rector\CodeQuality\Rector\Expression\InlineIfToExplicitIfRector

 class SomeClass
 {
     public function run()
     {
         $userId = null;

-        is_null($userId) && $userId = 5;
+        if (is_null($userId)) {
+            $userId = 5;
+        }
     }
 }

IntvalToTypeCastRector

Change intval() to faster and readable (int) $value

class: Rector\CodeQuality\Rector\FuncCall\IntvalToTypeCastRector

 class SomeClass
 {
     public function run($value)
     {
-        return intval($value);
+        return (int) $value;
     }
 }

IsAWithStringWithThirdArgumentRector

Complete missing 3rd argument in case is_a() function in case of strings

class: Rector\CodeQuality\Rector\FuncCall\IsAWithStringWithThirdArgumentRector

 class SomeClass
 {
     public function __construct(string $value)
     {
-        return is_a($value, 'stdClass');
+        return is_a($value, 'stdClass', true);
     }
 }

IssetOnPropertyObjectToPropertyExistsRector

Change isset on property object to property_exists()

class: Rector\CodeQuality\Rector\Isset_\IssetOnPropertyObjectToPropertyExistsRector

 class SomeClass
 {
     private $x;

     public function run(): void
     {
-        isset($this->x);
+        property_exists($this, 'x') && $this->x !== null;
     }
 }

JoinStringConcatRector

Joins concat of 2 strings, unless the length is too long

class: Rector\CodeQuality\Rector\Concat\JoinStringConcatRector

 class SomeClass
 {
     public function run()
     {
-        $name = 'Hi' . ' Tom';
+        $name = 'Hi Tom';
     }
 }

LogicalToBooleanRector

Change OR, AND to ||, && with more common understanding

class: Rector\CodeQuality\Rector\LogicalAnd\LogicalToBooleanRector

-if ($f = false or true) {
+if (($f = false) || true) {
     return $f;
 }

NewStaticToNewSelfRector

Change unsafe new static() to new self()

class: Rector\CodeQuality\Rector\New_\NewStaticToNewSelfRector

 class SomeClass
 {
     public function build()
     {
-        return new static();
+        return new self();
     }
 }

RemoveAlwaysTrueConditionSetInConstructorRector

If conditions is always true, perform the content right away

class: Rector\CodeQuality\Rector\FunctionLike\RemoveAlwaysTrueConditionSetInConstructorRector

 final class SomeClass
 {
     private $value;

     public function __construct($value)
     {
         $this->value = $value;
     }

     public function go()
     {
-        if ($this->value) {
-            return 'yes';
-        }
+        return 'yes';
     }
 }

RemoveSoleValueSprintfRector

Remove sprintf() wrapper if not needed

class: Rector\CodeQuality\Rector\FuncCall\RemoveSoleValueSprintfRector

 class SomeClass
 {
     public function run()
     {
-        $value = sprintf('%s', 'hi');
+        $value = 'hi';

         $welcome = 'hello';
-        $value = sprintf('%s', $welcome);
+        $value = $welcome;
     }
 }

SetTypeToCastRector

Changes settype() to (type) where possible

class: Rector\CodeQuality\Rector\FuncCall\SetTypeToCastRector

 class SomeClass
 {
-    public function run($foo)
+    public function run(array $items)
     {
-        settype($foo, 'string');
+        $foo = (string) $foo;

-        return settype($foo, 'integer');
+        return (int) $foo;
     }
 }

ShortenElseIfRector

Shortens else/if to elseif

class: Rector\CodeQuality\Rector\If_\ShortenElseIfRector

 class SomeClass
 {
     public function run()
     {
         if ($cond1) {
             return $action1;
-        } else {
-            if ($cond2) {
-                return $action2;
-            }
+        } elseif ($cond2) {
+            return $action2;
         }
     }
 }

SimplifyArraySearchRector

Simplify array_search to in_array

class: Rector\CodeQuality\Rector\Identical\SimplifyArraySearchRector

-array_search("searching", $array) !== false;
+in_array("searching", $array);

-array_search("searching", $array, true) !== false;
+in_array("searching", $array, true);

SimplifyBoolIdenticalTrueRector

Symplify bool value compare to true or false

class: Rector\CodeQuality\Rector\Identical\SimplifyBoolIdenticalTrueRector

 class SomeClass
 {
     public function run(bool $value, string $items)
     {
-         $match = in_array($value, $items, TRUE) === TRUE;
-         $match = in_array($value, $items, TRUE) !== FALSE;
+         $match = in_array($value, $items, TRUE);
+         $match = in_array($value, $items, TRUE);
     }
 }

SimplifyConditionsRector

Simplify conditions

class: Rector\CodeQuality\Rector\Identical\SimplifyConditionsRector

-if (! ($foo !== 'bar')) {...
+if ($foo === 'bar') {...

SimplifyDeMorganBinaryRector

Simplify negated conditions with de Morgan theorem

class: Rector\CodeQuality\Rector\BooleanNot\SimplifyDeMorganBinaryRector

 $a = 5;
 $b = 10;
-$result = !($a > 20 || $b <= 50);
+$result = $a <= 20 && $b > 50;

SimplifyDuplicatedTernaryRector

Remove ternary that duplicated return value of true : false

class: Rector\CodeQuality\Rector\Ternary\SimplifyDuplicatedTernaryRector

 class SomeClass
 {
     public function run(bool $value, string $name)
     {
-         $isTrue = $value ? true : false;
+         $isTrue = $value;
          $isName = $name ? true : false;
     }
 }

SimplifyEmptyArrayCheckRector

Simplify is_array and empty functions combination into a simple identical check for an empty array

class: Rector\CodeQuality\Rector\BooleanAnd\SimplifyEmptyArrayCheckRector

-is_array($values) && empty($values)
+$values === []

SimplifyForeachToArrayFilterRector

Simplify foreach with function filtering to array filter

class: Rector\CodeQuality\Rector\Foreach_\SimplifyForeachToArrayFilterRector

-$directories = [];
 $possibleDirectories = [];
-foreach ($possibleDirectories as $possibleDirectory) {
-    if (file_exists($possibleDirectory)) {
-        $directories[] = $possibleDirectory;
-    }
-}
+$directories = array_filter($possibleDirectories, 'file_exists');

SimplifyForeachToCoalescingRector

Changes foreach that returns set value to ??

class: Rector\CodeQuality\Rector\Foreach_\SimplifyForeachToCoalescingRector

-foreach ($this->oldToNewFunctions as $oldFunction => $newFunction) {
-    if ($currentFunction === $oldFunction) {
-        return $newFunction;
-    }
-}
-
-return null;
+return $this->oldToNewFunctions[$currentFunction] ?? null;

SimplifyFuncGetArgsCountRector

Simplify count of func_get_args() to func_num_args()

class: Rector\CodeQuality\Rector\FuncCall\SimplifyFuncGetArgsCountRector

-count(func_get_args());
+func_num_args();

SimplifyIfElseToTernaryRector

Changes if/else for same value as assign to ternary

class: Rector\CodeQuality\Rector\If_\SimplifyIfElseToTernaryRector

 class SomeClass
 {
     public function run()
     {
-        if (empty($value)) {
-            $this->arrayBuilt[][$key] = true;
-        } else {
-            $this->arrayBuilt[][$key] = $value;
-        }
+        $this->arrayBuilt[][$key] = empty($value) ? true : $value;
     }
 }

SimplifyIfIssetToNullCoalescingRector

Simplify binary if to null coalesce

class: Rector\CodeQuality\Rector\If_\SimplifyIfIssetToNullCoalescingRector

 final class SomeController
 {
     public function run($possibleStatieYamlFile)
     {
-        if (isset($possibleStatieYamlFile['import'])) {
-            $possibleStatieYamlFile['import'] = array_merge($possibleStatieYamlFile['import'], $filesToImport);
-        } else {
-            $possibleStatieYamlFile['import'] = $filesToImport;
-        }
+        $possibleStatieYamlFile['import'] = array_merge($possibleStatieYamlFile['import'] ?? [], $filesToImport);
     }
 }

SimplifyIfNotNullReturnRector

Changes redundant null check to instant return

class: Rector\CodeQuality\Rector\If_\SimplifyIfNotNullReturnRector

 $newNode = 'something ;
-if ($newNode !== null) {
-    return $newNode;
-}
-
-return null;
+return $newNode;

SimplifyIfReturnBoolRector

Shortens if return false/true to direct return

class: Rector\CodeQuality\Rector\If_\SimplifyIfReturnBoolRector

-if (strpos($docToken->getContent(), "\n") === false) {
-    return true;
-}
-
-return false;
+return strpos($docToken->getContent(), "\n") === false;

SimplifyInArrayValuesRector

Removes unneeded array_values() in in_array() call

class: Rector\CodeQuality\Rector\FuncCall\SimplifyInArrayValuesRector

-in_array("key", array_values($array), true);
+in_array("key", $array, true);

SimplifyRegexPatternRector

Simplify regex pattern to known ranges

class: Rector\CodeQuality\Rector\FuncCall\SimplifyRegexPatternRector

 class SomeClass
 {
     public function run($value)
     {
-        preg_match('#[a-zA-Z0-9+]#', $value);
+        preg_match('#[\w\d+]#', $value);
     }
 }

SimplifyStrposLowerRector

Simplify strpos(strtolower(), "...") calls

class: Rector\CodeQuality\Rector\FuncCall\SimplifyStrposLowerRector

-strpos(strtolower($var), "...")"
+stripos($var, "...")"

SimplifyTautologyTernaryRector

Simplify tautology ternary to value

class: Rector\CodeQuality\Rector\Ternary\SimplifyTautologyTernaryRector

-$value = ($fullyQualifiedTypeHint !== $typeHint) ? $fullyQualifiedTypeHint : $typeHint;
+$value = $fullyQualifiedTypeHint;

SimplifyUselessVariableRector

Removes useless variable assigns

class: Rector\CodeQuality\Rector\Return_\SimplifyUselessVariableRector

 function () {
-    $a = true;
-    return $a;
+    return true;
 };

SingleInArrayToCompareRector

Changes in_array() with single element to ===

class: Rector\CodeQuality\Rector\FuncCall\SingleInArrayToCompareRector

 class SomeClass
 {
     public function run()
     {
-        if (in_array(strtolower($type), ['$this'], true)) {
+        if (strtolower($type) === '$this') {
             return strtolower($type);
         }
     }
 }

SingularSwitchToIfRector

Change switch with only 1 check to if

class: Rector\CodeQuality\Rector\Switch_\SingularSwitchToIfRector

 class SomeObject
 {
     public function run($value)
     {
         $result = 1;
-        switch ($value) {
-            case 100:
+        if ($value === 100) {
             $result = 1000;
         }

         return $result;
     }
 }

SplitListAssignToSeparateLineRector

Splits [$a, $b] = [5, 10] scalar assign to standalone lines

class: Rector\CodeQuality\Rector\Assign\SplitListAssignToSeparateLineRector

 final class SomeClass
 {
     public function run(): void
     {
-        [$a, $b] = [1, 2];
+        $a = 1;
+        $b = 2;
     }
 }

StrlenZeroToIdenticalEmptyStringRector

Changes strlen comparison to 0 to direct empty string compare

class: Rector\CodeQuality\Rector\Identical\StrlenZeroToIdenticalEmptyStringRector

 class SomeClass
 {
     public function run($value)
     {
-        $empty = strlen($value) === 0;
+        $empty = $value === '';
     }
 }

SwitchNegatedTernaryRector

Switch negated ternary condition rector

class: Rector\CodeQuality\Rector\Ternary\SwitchNegatedTernaryRector

 class SomeClass
 {
     public function run(bool $upper, string $name)
     {
-        return ! $upper
-            ? $name
-            : strtoupper($name);
+        return $upper
+            ? strtoupper($name)
+            : $name;
     }
 }

ThrowWithPreviousExceptionRector

When throwing into a catch block, checks that the previous exception is passed to the new throw clause

class: Rector\CodeQuality\Rector\Catch_\ThrowWithPreviousExceptionRector

 class SomeClass
 {
     public function run()
     {
         try {
             $someCode = 1;
         } catch (Throwable $throwable) {
-            throw new AnotherException('ups');
+            throw new AnotherException('ups', $throwable->getCode(), $throwable);
         }
     }
 }

UnnecessaryTernaryExpressionRector

Remove unnecessary ternary expressions.

class: Rector\CodeQuality\Rector\Ternary\UnnecessaryTernaryExpressionRector

-$foo === $bar ? true : false;
+$foo === $bar;

UnusedForeachValueToArrayKeysRector

Change foreach with unused $value but only $key, to array_keys()

class: Rector\CodeQuality\Rector\Foreach_\UnusedForeachValueToArrayKeysRector

 class SomeClass
 {
     public function run()
     {
         $items = [];
-        foreach ($values as $key => $value) {
+        foreach (array_keys($values) as $key) {
             $items[$key] = null;
         }
     }
 }

UnwrapSprintfOneArgumentRector

unwrap sprintf() with one argument

class: Rector\CodeQuality\Rector\FuncCall\UnwrapSprintfOneArgumentRector

-echo sprintf('value');
+echo 'value';

UseIdenticalOverEqualWithSameTypeRector

Use ===/!== over ==/!=, it values have the same type

class: Rector\CodeQuality\Rector\Equal\UseIdenticalOverEqualWithSameTypeRector

 class SomeClass
 {
     public function run(int $firstValue, int $secondValue)
     {
-         $isSame = $firstValue == $secondValue;
-         $isDiffernt = $firstValue != $secondValue;
+         $isSame = $firstValue === $secondValue;
+         $isDiffernt = $firstValue !== $secondValue;
     }
 }

CodeQualityStrict

MoveOutMethodCallInsideIfConditionRector

Move out method call inside If condition

class: Rector\CodeQualityStrict\Rector\If_\MoveOutMethodCallInsideIfConditionRector

-if ($obj->run($arg) === 1) {
+$objRun = $obj->run($arg);
+if ($objRun === 1) {

 }

MoveVariableDeclarationNearReferenceRector

Move variable declaration near its reference

class: Rector\CodeQualityStrict\Rector\Variable\MoveVariableDeclarationNearReferenceRector

-$var = 1;
 if ($condition === null) {
+    $var = 1;
     return $var;
 }

ParamTypeToAssertTypeRector

Turn @param type to assert type

class: Rector\CodeQualityStrict\Rector\ClassMethod\ParamTypeToAssertTypeRector

 class SomeClass
 {
     /**
      * @param \A|\B $arg
      */
     public function run($arg)
     {
-
+        \Webmozart\Assert\Assert::isAnyOf($arg, [\A::class, \B::class]);
     }
 }

VarInlineAnnotationToAssertRector

Turn @var inline checks above code to assert() of the type

class: Rector\CodeQualityStrict\Rector\Stmt\VarInlineAnnotationToAssertRector

 class SomeClass
 {
     public function run()
     {
         /** @var SpecificClass $value */
+        assert($value instanceof SpecificClass);
         $value->call();
     }
 }

CodingStyle

AddArrayDefaultToArrayPropertyRector

Adds array default value to property to prevent foreach over null error

class: Rector\CodingStyle\Rector\Class_\AddArrayDefaultToArrayPropertyRector

 class SomeClass
 {
     /**
      * @var int[]
      */
-    private $values;
+    private $values = [];

     public function isEmpty()
     {
-        return $this->values === null;
+        return $this->values === [];
     }
 }

AddFalseDefaultToBoolPropertyRector

Add false default to bool properties, to prevent null compare errors

class: Rector\CodingStyle\Rector\Property\AddFalseDefaultToBoolPropertyRector

 class SomeClass
 {
     /**
      * @var bool
      */
-    private $isDisabled;
+    private $isDisabled = false;
 }

AnnotateThrowablesRector

Adds @throws DocBlock comments to methods that thrwo \Throwables.

class: Rector\CodingStyle\Rector\Throw_\AnnotateThrowablesRector

 class RootExceptionInMethodWithDocblock
 {
     /**
      * This is a comment.
      *
      * @param int $code
+     * @throws \RuntimeException
      */
     public function throwException(int $code)
     {
         throw new \RuntimeException('', $code);
     }
 }

BinarySwitchToIfElseRector

Changes switch with 2 options to if-else

class: Rector\CodingStyle\Rector\Switch_\BinarySwitchToIfElseRector

-switch ($foo) {
-    case 'my string':
-        $result = 'ok';
-    break;
-
-    default:
-        $result = 'not ok';
+if ($foo == 'my string') {
+    $result = 'ok;
+} else {
+    $result = 'not ok';
 }

CallUserFuncCallToVariadicRector

Replace call_user_func_call with variadic

class: Rector\CodingStyle\Rector\FuncCall\CallUserFuncCallToVariadicRector

 class SomeClass
 {
     public function run()
     {
-        call_user_func_array('some_function', $items);
+        some_function(...$items);
     }
 }

CamelCaseFunctionNamingToUnderscoreRector

Change CamelCase naming of functions to under_score naming

class: Rector\CodingStyle\Rector\Function_\CamelCaseFunctionNamingToUnderscoreRector

-function someCamelCaseFunction()
+function some_camel_case_function()
 {
 }

-someCamelCaseFunction();
+some_camel_case_function();

CatchExceptionNameMatchingTypeRector

Type and name of catch exception should match

class: Rector\CodingStyle\Rector\Catch_\CatchExceptionNameMatchingTypeRector

 class SomeClass
 {
     public function run()
     {
         try {
             // ...
-        } catch (SomeException $typoException) {
-            $typoException->getMessage();
+        } catch (SomeException $someException) {
+            $someException->getMessage();
         }
     }
 }

ConsistentImplodeRector

Changes various implode forms to consistent one

class: Rector\CodingStyle\Rector\FuncCall\ConsistentImplodeRector

 class SomeClass
 {
     public function run(array $items)
     {
-        $itemsAsStrings = implode($items);
-        $itemsAsStrings = implode($items, '|');
+        $itemsAsStrings = implode('', $items);
+        $itemsAsStrings = implode('|', $items);

         $itemsAsStrings = implode('|', $items);
     }
 }

ConsistentPregDelimiterRector

Replace PREG delimiter with configured one

🔧 configure it!

class: Rector\CodingStyle\Rector\FuncCall\ConsistentPregDelimiterRector

use Rector\CodingStyle\Rector\FuncCall\ConsistentPregDelimiterRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ConsistentPregDelimiterRector::class)
        ->call('configure', [[
            ConsistentPregDelimiterRector::DELIMITER => '#',
        ]]);
};

↓

 class SomeClass
 {
     public function run()
     {
-        preg_match('~value~', $value);
-        preg_match_all('~value~im', $value);
+        preg_match('#value#', $value);
+        preg_match_all('#value#im', $value);
     }
 }

EncapsedStringsToSprintfRector

Convert enscaped {$string} to more readable sprintf

class: Rector\CodingStyle\Rector\Encapsed\EncapsedStringsToSprintfRector

 final class SomeClass
 {
     public function run(string $format)
     {
-        return "Unsupported format {$format}";
+        return sprintf('Unsupported format %s', $format);
     }
 }

FollowRequireByDirRector

include/require should be followed by absolute path

class: Rector\CodingStyle\Rector\Include_\FollowRequireByDirRector

 class SomeClass
 {
     public function run()
     {
-        require 'autoload.php';
+        require __DIR__ . '/autoload.php';
     }
 }

FunctionCallToConstantRector

Changes use of function calls to use constants

🔧 configure it!

class: Rector\CodingStyle\Rector\FuncCall\FunctionCallToConstantRector

use Rector\CodingStyle\Rector\FuncCall\FunctionCallToConstantRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(FunctionCallToConstantRector::class)
        ->call('configure', [[
            FunctionCallToConstantRector::FUNCTIONS_TO_CONSTANTS => [
                'php_sapi_name' => 'PHP_SAPI',
            ],
        ]]);
};

↓

 class SomeClass
 {
     public function run()
     {
-        $value = php_sapi_name();
+        $value = PHP_SAPI;
     }
 }

use Rector\CodingStyle\Rector\FuncCall\FunctionCallToConstantRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(FunctionCallToConstantRector::class)
        ->call('configure', [[
            FunctionCallToConstantRector::FUNCTIONS_TO_CONSTANTS => [
                'pi' => 'M_PI',
            ],
        ]]);
};

↓

 class SomeClass
 {
     public function run()
     {
-        $value = pi();
+        $value = M_PI;
     }
 }

MakeInheritedMethodVisibilitySameAsParentRector

Make method visibility same as parent one

class: Rector\CodingStyle\Rector\ClassMethod\MakeInheritedMethodVisibilitySameAsParentRector

 class ChildClass extends ParentClass
 {
-    public function run()
+    protected function run()
     {
     }
 }

 class ParentClass
 {
     protected function run()
     {
     }
 }

ManualJsonStringToJsonEncodeArrayRector

Add extra space before new assign set

class: Rector\CodingStyle\Rector\Assign\ManualJsonStringToJsonEncodeArrayRector

+use Nette\Utils\Json;
+
 final class SomeClass
 {
     public function run()
     {
-        $someJsonAsString = '{"role_name":"admin","numberz":{"id":"10"}}';
+        $data = [
+            'role_name' => 'admin',
+            'numberz' => ['id' => 10]
+        ];
+        $someJsonAsString = Json::encode($data);
     }
 }

NewlineBeforeNewAssignSetRector

Add extra space before new assign set

class: Rector\CodingStyle\Rector\ClassMethod\NewlineBeforeNewAssignSetRector

 final class SomeClass
 {
     public function run()
     {
         $value = new Value;
         $value->setValue(5);
+
         $value2 = new Value;
         $value2->setValue(1);
     }
 }

NullableCompareToNullRector

Changes negate of empty comparison of nullable value to explicit === or !== compare

class: Rector\CodingStyle\Rector\If_\NullableCompareToNullRector

 /** @var stdClass|null $value */
-if ($value) {
+if ($value !== null) {
 }

-if (!$value) {
+if ($value === null) {
 }

PHPStormVarAnnotationRector

Change various @var annotation formats to one PHPStorm understands

class: Rector\CodingStyle\Rector\Assign\PHPStormVarAnnotationRector

-$config = 5;
-/** @var \Shopsys\FrameworkBundle\Model\Product\Filter\ProductFilterConfig $config */
+/** @var \Shopsys\FrameworkBundle\Model\Product\Filter\ProductFilterConfig $config */
+$config = 5;

PostIncDecToPreIncDecRector

Use ++$value or --$value instead of $value++ or $value--

class: Rector\CodingStyle\Rector\PostInc\PostIncDecToPreIncDecRector

 class SomeClass
 {
     public function run($value = 1)
     {
-        $value++; echo $value;
-        $value--; echo $value;
+        ++$value; echo $value;
+        --$value; echo $value;
     }
 }

PreferThisOrSelfMethodCallRector

Changes $this->... and static:: to self:: or vise versa for given types

🔧 configure it!

class: Rector\CodingStyle\Rector\MethodCall\PreferThisOrSelfMethodCallRector

use PHPUnit\Framework\TestCase;
use Rector\CodingStyle\Rector\MethodCall\PreferThisOrSelfMethodCallRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(PreferThisOrSelfMethodCallRector::class)
        ->call('configure', [[
            PreferThisOrSelfMethodCallRector::TYPE_TO_PREFERENCE => [
                TestCase::class => 'self',
            ],
        ]]);
};

↓

 class SomeClass extends \PHPUnit\Framework\TestCase
 {
     public function run()
     {
-        $this->assertEquals('a', 'a');
+        self::assertEquals('a', 'a');
     }
 }

RemoveDoubleUnderscoreInMethodNameRector

Non-magic PHP object methods cannot start with "__"

class: Rector\CodingStyle\Rector\ClassMethod\RemoveDoubleUnderscoreInMethodNameRector

 class SomeClass
 {
-    public function __getName($anotherObject)
+    public function getName($anotherObject)
     {
-        $anotherObject->__getSurname();
+        $anotherObject->getSurname();
     }
 }

RemoveUnusedAliasRector

Removes unused use aliases. Keep annotation aliases like "Doctrine\ORM\Mapping as ORM" to keep convention format

class: Rector\CodingStyle\Rector\Use_\RemoveUnusedAliasRector

-use Symfony\Kernel as BaseKernel;
+use Symfony\Kernel;

-class SomeClass extends BaseKernel
+class SomeClass extends Kernel
 {
 }

ReturnArrayClassMethodToYieldRector

Turns array return to yield return in specific type and method

🔧 configure it!

class: Rector\CodingStyle\Rector\ClassMethod\ReturnArrayClassMethodToYieldRector

use Rector\CodingStyle\Rector\ClassMethod\ReturnArrayClassMethodToYieldRector;
use Rector\CodingStyle\ValueObject\ReturnArrayClassMethodToYield;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ReturnArrayClassMethodToYieldRector::class)
        ->call('configure', [[
            ReturnArrayClassMethodToYieldRector::METHODS_TO_YIELDS => ValueObjectInliner::inline([
                new ReturnArrayClassMethodToYield('EventSubscriberInterface', 'getSubscribedEvents'),
            ]),
        ]]);
};

↓

 class SomeEventSubscriber implements EventSubscriberInterface
 {
     public static function getSubscribedEvents()
     {
-        return ['event' => 'callback'];
+        yield 'event' => 'callback';
     }
 }

SplitDoubleAssignRector

Split multiple inline assigns to each own lines default value, to prevent undefined array issues

class: Rector\CodingStyle\Rector\Assign\SplitDoubleAssignRector

 class SomeClass
 {
     public function run()
     {
-        $one = $two = 1;
+        $one = 1;
+        $two = 1;
     }
 }

SplitGroupedConstantsAndPropertiesRector

Separate constant and properties to own lines

class: Rector\CodingStyle\Rector\ClassConst\SplitGroupedConstantsAndPropertiesRector

 class SomeClass
 {
-    const HI = true, AHOJ = 'true';
+    const HI = true;
+    const AHOJ = 'true';

     /**
      * @var string
      */
-    public $isIt, $isIsThough;
+    public $isIt;
+
+    /**
+     * @var string
+     */
+    public $isIsThough;
 }

SplitGroupedUseImportsRector

Split grouped use imports and trait statements to standalone lines

class: Rector\CodingStyle\Rector\Use_\SplitGroupedUseImportsRector

-use A, B;
+use A;
+use B;

 class SomeClass
 {
-    use SomeTrait, AnotherTrait;
+    use SomeTrait;
+    use AnotherTrait;
 }

SplitStringClassConstantToClassConstFetchRector

Separate class constant in a string to class constant fetch and string

class: Rector\CodingStyle\Rector\String_\SplitStringClassConstantToClassConstFetchRector

 class SomeClass
 {
     const HI = true;
 }

 class AnotherClass
 {
     public function get()
     {
-        return 'SomeClass::HI';
+        return SomeClass::class . '::HI';
     }
 }

StrictArraySearchRector

Makes array_search search for identical elements

class: Rector\CodingStyle\Rector\FuncCall\StrictArraySearchRector

-array_search($value, $items);
+array_search($value, $items, true);

SymplifyQuoteEscapeRector

Prefer quote that are not inside the string

class: Rector\CodingStyle\Rector\String_\SymplifyQuoteEscapeRector

 class SomeClass
 {
     public function run()
     {
-         $name = "\" Tom";
-         $name = '\' Sara';
+         $name = '" Tom';
+         $name = "' Sara";
     }
 }

TernaryConditionVariableAssignmentRector

Assign outcome of ternary condition to variable, where applicable

class: Rector\CodingStyle\Rector\Ternary\TernaryConditionVariableAssignmentRector

 function ternary($value)
 {
-    $value ? $a = 1 : $a = 0;
+    $a = $value ? 1 : 0;
 }

UnSpreadOperatorRector

Remove spread operator

class: Rector\CodingStyle\Rector\ClassMethod\UnSpreadOperatorRector

 class SomeClass
 {
-    public function run(...$array)
+    public function run(array $array)
     {
     }

     public function execute(array $data)
     {
-        $this->run(...$data);
+        $this->run($data);
     }
 }

UseClassKeywordForClassNameResolutionRector

Use class keyword for class name resolution in string instead of hardcoded string reference

class: Rector\CodingStyle\Rector\String_\UseClassKeywordForClassNameResolutionRector

-$value = 'App\SomeClass::someMethod()';
+$value = \App\SomeClass . '::someMethod()';

UseIncrementAssignRector

Use ++ increment instead of $var += 1

class: Rector\CodingStyle\Rector\Plus\UseIncrementAssignRector

 class SomeClass
 {
     public function run()
     {
-        $style += 1;
+        ++$style;
     }
 }

UseMessageVariableForSprintfInSymfonyStyleRector

Decouple $message property from sprintf() calls in $this->symfonyStyle->method()

class: Rector\CodingStyle\Rector\MethodCall\UseMessageVariableForSprintfInSymfonyStyleRector

 use Symfony\Component\Console\Style\SymfonyStyle;

 final class SomeClass
 {
     public function run(SymfonyStyle $symfonyStyle)
     {
-        $symfonyStyle->info(sprintf('Hi %s', 'Tom'));
+        $message = sprintf('Hi %s', 'Tom');
+        $symfonyStyle->info($message);
     }
 }

VarConstantCommentRector

Constant should have a @var comment with type

class: Rector\CodingStyle\Rector\ClassConst\VarConstantCommentRector

 class SomeClass
 {
+    /**
+     * @var string
+     */
     const HI = 'hi';
 }

VersionCompareFuncCallToConstantRector

Changes use of call to version compare function to use of PHP version constant

class: Rector\CodingStyle\Rector\FuncCall\VersionCompareFuncCallToConstantRector

 class SomeClass
 {
     public function run()
     {
-        version_compare(PHP_VERSION, '5.3.0', '<');
+        PHP_VERSION_ID < 50300;
     }
 }

WrapEncapsedVariableInCurlyBracesRector

Wrap encapsed variables in curly braces

class: Rector\CodingStyle\Rector\Encapsed\WrapEncapsedVariableInCurlyBracesRector

 function run($world)
 {
-    echo "Hello $world!"
+    echo "Hello {$world}!"
 }

YieldClassMethodToArrayClassMethodRector

Turns yield return to array return in specific type and method

🔧 configure it!

class: Rector\CodingStyle\Rector\ClassMethod\YieldClassMethodToArrayClassMethodRector

use Rector\CodingStyle\Rector\ClassMethod\YieldClassMethodToArrayClassMethodRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(YieldClassMethodToArrayClassMethodRector::class)
        ->call('configure', [[
            YieldClassMethodToArrayClassMethodRector::METHODS_BY_TYPE => [
                'EventSubscriberInterface' => ['getSubscribedEvents'],
            ],
        ]]);
};

↓

 class SomeEventSubscriber implements EventSubscriberInterface
 {
     public static function getSubscribedEvents()
     {
-        yield 'event' => 'callback';
+        return ['event' => 'callback'];
     }
 }

Composer

AddPackageToRequireDevRector

Add package to "require-dev" in composer.json

🔧 configure it!

class: Rector\Composer\Rector\AddPackageToRequireDevRector

use Rector\Composer\Rector\AddPackageToRequireDevComposerRector;
use Rector\Composer\ValueObject\PackageAndVersion;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(AddPackageToRequireDevComposerRector::class)
        ->call('configure', [[
            AddPackageToRequireDevComposerRector::PACKAGES_AND_VERSIONS => ValueObjectInliner::inline([
                new PackageAndVersion('symfony/console', '^3.4'),
            ]),
        ]]);
};

↓

 {
+    "require-dev": {
+        "symfony/console": "^3.4"
+    }
 }

AddPackageToRequireRector

Add package to "require" in composer.json

🔧 configure it!

class: Rector\Composer\Rector\AddPackageToRequireRector

use Rector\Composer\Rector\AddPackageToRequireComposerRector;
use Rector\Composer\ValueObject\PackageAndVersion;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(AddPackageToRequireComposerRector::class)
        ->call('configure', [[
            AddPackageToRequireComposerRector::PACKAGES_AND_VERSIONS => ValueObjectInliner::inline([
                new PackageAndVersion('symfony/console', '^3.4'),
            ]),
        ]]);
};

↓

 {
+    "require": {
+        "symfony/console": "^3.4"
+    }
 }

ChangePackageVersionRector

Change package version composer.json

🔧 configure it!

class: Rector\Composer\Rector\ChangePackageVersionRector

use Rector\Composer\Rector\ChangePackageVersionComposerRector;
use Rector\Composer\ValueObject\PackageAndVersion;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ChangePackageVersionComposerRector::class)
        ->call('configure', [[
            ChangePackageVersionComposerRector::PACKAGES_AND_VERSIONS => ValueObjectInliner::inline([
                new PackageAndVersion('symfony/console', '^4.4'),
            ]),
        ]]);
};

↓

 {
-    "require-dev": {
-        "symfony/console": "^3.4"
+    "require": {
+        "symfony/console": "^4.4"
     }
 }

MovePackageToRequireDevRector

Moves package from "require" to "require-dev" in composer.json

🔧 configure it!

class: Rector\Composer\Rector\MovePackageToRequireDevRector

use Rector\Composer\Rector\MovePackageToRequireDevComposerRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(MovePackageToRequireDevComposerRector::class)
        ->call('configure', [[
            MovePackageToRequireDevComposerRector::PACKAGE_NAMES => ['symfony/console'],
        ]]);
};

↓

 {
-    "require": {
+    "require-dev": {
         "symfony/console": "^3.4"
     }
 }

MovePackageToRequireRector

Moves package from "require-dev" to "require" in composer.json

🔧 configure it!

class: Rector\Composer\Rector\MovePackageToRequireRector

use Rector\Composer\Rector\MovePackageToRequireComposerRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(MovePackageToRequireComposerRector::class)
        ->call('configure', [[
            MovePackageToRequireComposerRector::PACKAGE_NAMES => ['symfony/console'],
        ]]);
};

↓

 {
-    "require-dev": {
+    "require": {
         "symfony/console": "^3.4"
     }
 }

RemovePackageRector

Remove package from "require" and "require-dev" in composer.json

🔧 configure it!

class: Rector\Composer\Rector\RemovePackageRector

use Rector\Composer\Rector\RemovePackageComposerRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(RemovePackageComposerRector::class)
        ->call('configure', [[
            RemovePackageComposerRector::PACKAGE_NAMES => ['symfony/console'],
        ]]);
};

↓

 {
-    "require": {
-        "symfony/console": "^3.4"
-    }
 }

ReplacePackageAndVersionRector

Change package name and version composer.json

🔧 configure it!

class: Rector\Composer\Rector\ReplacePackageAndVersionRector

use Rector\Composer\Rector\ReplacePackageAndVersionComposerRector;
use Rector\Composer\ValueObject\ReplacePackageAndVersion;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ReplacePackageAndVersionComposerRector::class)
        ->call('configure', [[
            ReplacePackageAndVersionComposerRector::REPLACE_PACKAGES_AND_VERSIONS => ValueObjectInliner::inline([
                new ReplacePackageAndVersion('symfony/console', 'symfony/http-kernel', '^4.4'),
            ]),
        ]]);
};

↓

 {
     "require-dev": {
-        "symfony/console": "^3.4"
+        "symfony/http-kernel": "^4.4"
     }
 }

DeadCode

RecastingRemovalRector

Removes recasting of the same type

class: Rector\DeadCode\Rector\Cast\RecastingRemovalRector

 $string = '';
-$string = (string) $string;
+$string = $string;

 $array = [];
-$array = (array) $array;
+$array = $array;

RemoveAlwaysTrueIfConditionRector

Remove if condition that is always true

class: Rector\DeadCode\Rector\If_\RemoveAlwaysTrueIfConditionRector

 final class SomeClass
 {
     public function go()
     {
-        if (1 === 1) {
-            return 'yes';
-        }
+        return 'yes';

         return 'no';
     }
 }

RemoveAndTrueRector

Remove and true that has no added value

class: Rector\DeadCode\Rector\BooleanAnd\RemoveAndTrueRector

 class SomeClass
 {
     public function run()
     {
-        return true && 5 === 1;
+        return 5 === 1;
     }
 }

RemoveAssignOfVoidReturnFunctionRector

Remove assign of void function/method to variable

class: Rector\DeadCode\Rector\Assign\RemoveAssignOfVoidReturnFunctionRector

 class SomeClass
 {
     public function run()
     {
-        $value = $this->getOne();
+        $this->getOne();
     }

     private function getOne(): void
     {
     }
 }

RemoveCodeAfterReturnRector

Remove dead code after return statement

class: Rector\DeadCode\Rector\FunctionLike\RemoveCodeAfterReturnRector

 class SomeClass
 {
     public function run(int $a)
     {
          return $a;
-         $a++;
     }
 }

RemoveConcatAutocastRector

Remove (string) casting when it comes to concat, that does this by default

class: Rector\DeadCode\Rector\Concat\RemoveConcatAutocastRector

 class SomeConcatingClass
 {
     public function run($value)
     {
-        return 'hi ' . (string) $value;
+        return 'hi ' . $value;
     }
 }

RemoveDeadConditionAboveReturnRector

Remove dead condition above return

class: Rector\DeadCode\Rector\Return_\RemoveDeadConditionAboveReturnRector

 final class SomeClass
 {
     public function go()
     {
-        if (1 === 1) {
-            return 'yes';
-        }
-
         return 'yes';
     }
 }

RemoveDeadConstructorRector

Remove empty constructor

class: Rector\DeadCode\Rector\ClassMethod\RemoveDeadConstructorRector

 class SomeClass
 {
-    public function __construct()
-    {
-    }
 }

RemoveDeadIfForeachForRector

Remove if, foreach and for that does not do anything

class: Rector\DeadCode\Rector\For_\RemoveDeadIfForeachForRector

 class SomeClass
 {
     public function run($someObject)
     {
         $value = 5;
-        if ($value) {
-        }
-
         if ($someObject->run()) {
-        }
-
-        foreach ($values as $value) {
         }

         return $value;
     }
 }

RemoveDeadRecursiveClassMethodRector

Remove unused public method that only calls itself recursively

class: Rector\DeadCode\Rector\ClassMethod\RemoveDeadRecursiveClassMethodRector

 class SomeClass
 {
-    public function run()
-    {
-        return $this->run();
-    }
 }

RemoveDeadReturnRector

Remove last return in the functions, since does not do anything

class: Rector\DeadCode\Rector\FunctionLike\RemoveDeadReturnRector

 class SomeClass
 {
     public function run()
     {
         $shallWeDoThis = true;

         if ($shallWeDoThis) {
             return;
         }
-
-        return;
     }
 }

RemoveDeadStmtRector

Removes dead code statements

class: Rector\DeadCode\Rector\Expression\RemoveDeadStmtRector

-$value = 5;
-$value;
+$value = 5;

RemoveDeadTryCatchRector

Remove dead try/catch

class: Rector\DeadCode\Rector\TryCatch\RemoveDeadTryCatchRector

 class SomeClass
 {
     public function run()
     {
-        try {
-            // some code
-        }
-        catch (Throwable $throwable) {
-            throw $throwable;
-        }
+        // some code
     }
 }

RemoveDeadZeroAndOneOperationRector

Remove operation with 1 and 0, that have no effect on the value

class: Rector\DeadCode\Rector\Plus\RemoveDeadZeroAndOneOperationRector

 class SomeClass
 {
     public function run()
     {
-        $value = 5 * 1;
-        $value = 5 + 0;
+        $value = 5;
+        $value = 5;
     }
 }

RemoveDefaultArgumentValueRector

Remove argument value, if it is the same as default value

class: Rector\DeadCode\Rector\MethodCall\RemoveDefaultArgumentValueRector

 class SomeClass
 {
     public function run()
     {
-        $this->runWithDefault([]);
-        $card = self::runWithStaticDefault([]);
+        $this->runWithDefault();
+        $card = self::runWithStaticDefault();
     }

     public function runWithDefault($items = [])
     {
         return $items;
     }

     public function runStaticWithDefault($cards = [])
     {
         return $cards;
     }
 }

RemoveDelegatingParentCallRector

Removed dead parent call, that does not change anything

class: Rector\DeadCode\Rector\ClassMethod\RemoveDelegatingParentCallRector

 class SomeClass
 {
-    public function prettyPrint(array $stmts): string
-    {
-        return parent::prettyPrint($stmts);
-    }
 }

RemoveDoubleAssignRector

Simplify useless double assigns

class: Rector\DeadCode\Rector\Assign\RemoveDoubleAssignRector

-$value = 1;
 $value = 1;

RemoveDuplicatedArrayKeyRector

Remove duplicated key in defined arrays.

class: Rector\DeadCode\Rector\Array_\RemoveDuplicatedArrayKeyRector

 $item = [
-    1 => 'A',
     1 => 'B'
 ];

RemoveDuplicatedCaseInSwitchRector

2 following switch keys with identical will be reduced to one result

class: Rector\DeadCode\Rector\Switch_\RemoveDuplicatedCaseInSwitchRector

 class SomeClass
 {
     public function run()
     {
         switch ($name) {
              case 'clearHeader':
                  return $this->modifyHeader($node, 'remove');
              case 'clearAllHeaders':
-                 return $this->modifyHeader($node, 'replace');
              case 'clearRawHeaders':
                  return $this->modifyHeader($node, 'replace');
              case '...':
                  return 5;
         }
     }
 }

RemoveDuplicatedIfReturnRector

Remove duplicated if stmt with return in function/method body

class: Rector\DeadCode\Rector\FunctionLike\RemoveDuplicatedIfReturnRector

 class SomeClass
 {
     public function run($value)
     {
         if ($value) {
             return true;
         }

         $value2 = 100;
-
-        if ($value) {
-            return true;
-        }
     }
 }

RemoveDuplicatedInstanceOfRector

Remove duplicated instanceof in one call

class: Rector\DeadCode\Rector\BinaryOp\RemoveDuplicatedInstanceOfRector

 class SomeClass
 {
-    public function run($value)
+    public function run($value): void
     {
-        $isIt = $value instanceof A || $value instanceof A;
-        $isIt = $value instanceof A && $value instanceof A;
+        $isIt = $value instanceof A;
+        $isIt = $value instanceof A;
     }
 }

RemoveEmptyClassMethodRector

Remove empty method calls not required by parents

class: Rector\DeadCode\Rector\ClassMethod\RemoveEmptyClassMethodRector

 class OrphanClass
 {
-    public function __construct()
-    {
-    }
 }

RemoveEmptyMethodCallRector

Remove empty method call

class: Rector\DeadCode\Rector\MethodCall\RemoveEmptyMethodCallRector

 class SomeClass
 {
     public function callThis()
     {
     }
 }

-$some = new SomeClass();
-$some->callThis();
+$some = new SomeClass();

RemoveNullPropertyInitializationRector

Remove initialization with null value from property declarations

class: Rector\DeadCode\Rector\PropertyProperty\RemoveNullPropertyInitializationRector

 class SunshineCommand extends ParentClassWithNewConstructor
 {
-    private $myVar = null;
+    private $myVar;
 }

RemoveOverriddenValuesRector

Remove initial assigns of overridden values

class: Rector\DeadCode\Rector\FunctionLike\RemoveOverriddenValuesRector

 final class SomeController
 {
     public function run()
     {
-         $directories = [];
          $possibleDirectories = [];
          $directories = array_filter($possibleDirectories, 'file_exists');
     }
 }

RemoveParentCallWithoutParentRector

Remove unused parent call with no parent class

class: Rector\DeadCode\Rector\StaticCall\RemoveParentCallWithoutParentRector

 class OrphanClass
 {
     public function __construct()
     {
-         parent::__construct();
     }
 }

RemoveSetterOnlyPropertyAndMethodCallRector

Removes method that set values that are never used

class: Rector\DeadCode\Rector\Property\RemoveSetterOnlyPropertyAndMethodCallRector

 class SomeClass
 {
-    private $name;
-
-    public function setName($name)
-    {
-        $this->name = $name;
-    }
 }

 class ActiveOnlySetter
 {
     public function run()
     {
         $someClass = new SomeClass();
-        $someClass->setName('Tom');
     }
 }

RemoveUnreachableStatementRector

Remove unreachable statements

class: Rector\DeadCode\Rector\Stmt\RemoveUnreachableStatementRector

 class SomeClass
 {
     public function run()
     {
         return 5;
-
-        $removeMe = 10;
     }
 }

RemoveUnusedAssignVariableRector

Remove assigned unused variable

class: Rector\DeadCode\Rector\Assign\RemoveUnusedAssignVariableRector

 class SomeClass
 {
     public function run()
     {
-        $value = $this->process();
+        $this->process();
     }

     public function process()
     {
         // something going on
         return 5;
     }
 }

RemoveUnusedClassConstantRector

Remove unused class constants

class: Rector\DeadCode\Rector\ClassConst\RemoveUnusedClassConstantRector

 class SomeClass
 {
-    private const SOME_CONST = 'dead';
-
     public function run()
     {
     }
 }

RemoveUnusedClassesRector

Remove unused classes without interface

class: Rector\DeadCode\Rector\Class_\RemoveUnusedClassesRector

 interface SomeInterface
 {
 }

 class SomeClass implements SomeInterface
 {
     public function run($items)
     {
         return null;
     }
-}
-
-class NowhereUsedClass
-{
 }

RemoveUnusedDoctrineEntityMethodAndPropertyRector

Removes unused methods and properties from Doctrine entity classes

class: Rector\DeadCode\Rector\Class_\RemoveUnusedDoctrineEntityMethodAndPropertyRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class UserEntity
 {
-    /**
-     * @ORM\Column
-     */
-    private $name;
-
-    public function getName()
-    {
-        return $this->name;
-    }
-
-    public function setName($name)
-    {
-        $this->name = $name;
-    }
 }

RemoveUnusedForeachKeyRector

Remove unused key in foreach

class: Rector\DeadCode\Rector\Foreach_\RemoveUnusedForeachKeyRector

 $items = [];
-foreach ($items as $key => $value) {
+foreach ($items as $value) {
     $result = $value;
 }

RemoveUnusedFunctionRector

Remove unused function

class: Rector\DeadCode\Rector\Function_\RemoveUnusedFunctionRector

-function removeMe()
-{
-}
-
 function useMe()
 {
 }

 useMe();

RemoveUnusedNonEmptyArrayBeforeForeachRector

Remove unused if check to non-empty array before foreach of the array

class: Rector\DeadCode\Rector\If_\RemoveUnusedNonEmptyArrayBeforeForeachRector

 class SomeClass
 {
     public function run()
     {
         $values = [];
-        if ($values !== []) {
-            foreach ($values as $value) {
-                echo $value;
-            }
+        foreach ($values as $value) {
+            echo $value;
         }
     }
 }

RemoveUnusedParameterRector

Remove unused parameter, if not required by interface or parent class

class: Rector\DeadCode\Rector\ClassMethod\RemoveUnusedParameterRector

 class SomeClass
 {
-    public function __construct($value, $value2)
+    public function __construct($value)
     {
          $this->value = $value;
     }
 }

RemoveUnusedPrivateConstantRector

Remove unused private constant

class: Rector\DeadCode\Rector\ClassConst\RemoveUnusedPrivateConstantRector

 final class SomeController
 {
-    private const SOME_CONSTANT = 5;
     public function run()
     {
         return 5;
     }
 }

RemoveUnusedPrivateMethodRector

Remove unused private method

class: Rector\DeadCode\Rector\ClassMethod\RemoveUnusedPrivateMethodRector

 final class SomeController
 {
     public function run()
     {
         return 5;
     }
-
-    private function skip()
-    {
-        return 10;
-    }
 }

RemoveUnusedPrivatePropertyRector

Remove unused private properties

class: Rector\DeadCode\Rector\Property\RemoveUnusedPrivatePropertyRector

 class SomeClass
 {
-    private $property;
 }

RemoveUnusedPublicMethodRector

Remove unused public method

class: Rector\DeadCode\Rector\ClassMethod\RemoveUnusedPublicMethodRector

 class SomeClass
 {
-    public function unusedpublicMethod()
-    {
-        // ...
-    }
-
     public function execute()
     {
         // ...
     }

     public function run()
     {
         $obj = new self;
         $obj->execute();
     }
 }

RemoveUnusedVariableAssignRector

Remove unused assigns to variables

class: Rector\DeadCode\Rector\Assign\RemoveUnusedVariableAssignRector

 class SomeClass
 {
     public function run()
     {
-        $value = 5;
     }
 }

RemoveUselessJustForSakeInterfaceRector

Remove interface, that are added just for its sake, but nowhere useful

class: Rector\DeadCode\Rector\Class_\RemoveUselessJustForSakeInterfaceRector

-class SomeClass implements OnlyHereUsedInterface
+class SomeClass
 {
 }

-interface OnlyHereUsedInterface
-{
-}
-
 class SomePresenter
 {
-    public function __construct(OnlyHereUsedInterface $onlyHereUsed)
+    public function __construct(SomeClass $onlyHereUsed)
     {
     }
 }

SimplifyIfElseWithSameContentRector

Remove if/else if they have same content

class: Rector\DeadCode\Rector\If_\SimplifyIfElseWithSameContentRector

 class SomeClass
 {
     public function run()
     {
-        if (true) {
-            return 1;
-        } else {
-            return 1;
-        }
+        return 1;
     }
 }

SimplifyMirrorAssignRector

Removes unneeded $a = $a assigns

class: Rector\DeadCode\Rector\Expression\SimplifyMirrorAssignRector

-$a = $a;

TernaryToBooleanOrFalseToBooleanAndRector

Change ternary of bool : false to && bool

class: Rector\DeadCode\Rector\Ternary\TernaryToBooleanOrFalseToBooleanAndRector

 class SomeClass
 {
     public function go()
     {
-        return $value ? $this->getBool() : false;
+        return $value && $this->getBool();
     }

     private function getBool(): bool
     {
         return (bool) 5;
     }
 }

DeadDocBlock

RemoveNonExistingVarAnnotationRector

Removes non-existing @var annotations above the code

class: Rector\DeadDocBlock\Rector\Node\RemoveNonExistingVarAnnotationRector

 class SomeClass
 {
     public function get()
     {
-        /** @var Training[] $trainings */
         return $this->getData();
     }
 }

RemoveUselessParamTagRector

Remove @param docblock with same type as parameter type

class: Rector\DeadDocBlock\Rector\ClassMethod\RemoveUselessParamTagRector

 class SomeClass
 {
     /**
-     * @param string $a
      * @param string $b description
      */
     public function foo(string $a, string $b)
     {
     }
 }

RemoveUselessReturnTagRector

Remove @return docblock with same type as defined in PHP

class: Rector\DeadDocBlock\Rector\ClassMethod\RemoveUselessReturnTagRector

 use stdClass;

 class SomeClass
 {
-    /**
-     * @return stdClass
-     */
     public function foo(): stdClass
     {
     }
 }

Defluent

DefluentReturnMethodCallRector

Turns return of fluent, to standalone call line and return of value

class: Rector\Defluent\Rector\Return_\DefluentReturnMethodCallRector

 $someClass = new SomeClass();
-return $someClass->someFunction();
+$someClass->someFunction();
+return $someClass;

FluentChainMethodCallToNormalMethodCallRector

Turns fluent interface calls to classic ones.

class: Rector\Defluent\Rector\MethodCall\FluentChainMethodCallToNormalMethodCallRector

 $someClass = new SomeClass();
-$someClass->someFunction()
-            ->otherFunction();
+$someClass->someFunction();
+$someClass->otherFunction();

InArgFluentChainMethodCallToStandaloneMethodCallRector

Turns fluent interface calls to classic ones.

class: Rector\Defluent\Rector\MethodCall\InArgFluentChainMethodCallToStandaloneMethodCallRector

 class UsedAsParameter
 {
     public function someFunction(FluentClass $someClass)
     {
-        $this->processFluentClass($someClass->someFunction()->otherFunction());
+        $someClass->someFunction();
+        $someClass->otherFunction();
+        $this->processFluentClass($someClass);
     }

     public function processFluentClass(FluentClass $someClass)
     {
     }
-}
+}

MethodCallOnSetterMethodCallToStandaloneAssignRector

Change method call on setter to standalone assign before the setter

class: Rector\Defluent\Rector\MethodCall\MethodCallOnSetterMethodCallToStandaloneAssignRector

 class SomeClass
 {
     public function some()
     {
-        $this->anotherMethod(new AnotherClass())
-            ->someFunction();
+        $anotherClass = new AnotherClass();
+        $anotherClass->someFunction();
+        $this->anotherMethod($anotherClass);
     }

     public function anotherMethod(AnotherClass $anotherClass)
     {
     }
 }

NewFluentChainMethodCallToNonFluentRector

Turns fluent interface calls to classic ones.

class: Rector\Defluent\Rector\MethodCall\NewFluentChainMethodCallToNonFluentRector

-(new SomeClass())->someFunction()
-            ->otherFunction();
+$someClass = new SomeClass();
+$someClass->someFunction();
+$someClass->otherFunction();

ReturnFluentChainMethodCallToNormalMethodCallRector

Turns fluent interface calls to classic ones.

class: Rector\Defluent\Rector\Return_\ReturnFluentChainMethodCallToNormalMethodCallRector

 $someClass = new SomeClass();
-return $someClass->someFunction()
-            ->otherFunction();
+$someClass->someFunction();
+$someClass->otherFunction();
+return $someClass;

ReturnNewFluentChainMethodCallToNonFluentRector

Turns fluent interface calls to classic ones.

class: Rector\Defluent\Rector\Return_\ReturnNewFluentChainMethodCallToNonFluentRector

-return (new SomeClass())->someFunction()
-            ->otherFunction();
+$someClass = new SomeClass();
+$someClass->someFunction();
+$someClass->otherFunction();
+return $someClass;

ReturnThisRemoveRector

Removes "return $this;" from fluent interfaces for specified classes.

class: Rector\Defluent\Rector\ClassMethod\ReturnThisRemoveRector

 class SomeExampleClass
 {
     public function someFunction()
     {
-        return $this;
     }

     public function otherFunction()
     {
-        return $this;
     }
 }

DependencyInjection

MultiParentingToAbstractDependencyRector

Move dependency passed to all children to parent as @inject/@required dependency

🔧 configure it!

class: Rector\DependencyInjection\Rector\Class_\MultiParentingToAbstractDependencyRector

use Rector\DependencyInjection\Rector\Class_\MultiParentingToAbstractDependencyRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(MultiParentingToAbstractDependencyRector::class)
        ->call('configure', [[
            MultiParentingToAbstractDependencyRector::FRAMEWORK => 'nette',
        ]]);
};

↓

 abstract class AbstractParentClass
 {
-    private $someDependency;
-
-    public function __construct(SomeDependency $someDependency)
-    {
-        $this->someDependency = $someDependency;
-    }
+    /**
+     * @inject
+     * @var SomeDependency
+     */
+    public $someDependency;
 }

 class FirstChild extends AbstractParentClass
 {
-    public function __construct(SomeDependency $someDependency)
-    {
-        parent::__construct($someDependency);
-    }
 }

 class SecondChild extends AbstractParentClass
 {
-    public function __construct(SomeDependency $someDependency)
-    {
-        parent::__construct($someDependency);
-    }
 }

Doctrine

AddEntityIdByConditionRector

Add entity id with annotations when meets condition

🔧 configure it!

class: Rector\Doctrine\Rector\Class_\AddEntityIdByConditionRector

use Rector\Doctrine\Rector\Class_\AddEntityIdByConditionRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(AddEntityIdByConditionRector::class)
        ->call('configure', [[
            AddEntityIdByConditionRector::DETECTED_TRAITS => [
                'Knp\DoctrineBehaviors\Model\Translatable\Translation',
                'Knp\DoctrineBehaviors\Model\Translatable\TranslationTrait',
            ],
        ]]);
};

↓

 class SomeClass
 {
     use SomeTrait;
+
+    /**
+      * @ORM\Id
+      * @ORM\Column(type="integer")
+      * @ORM\GeneratedValue(strategy="AUTO")
+      */
+     private $id;
+
+    public function getId(): int
+    {
+        return $this->id;
+    }
 }

AddUuidAnnotationsToIdPropertyRector

Add uuid annotations to $id property

class: Rector\Doctrine\Rector\Property\AddUuidAnnotationsToIdPropertyRector

 use Doctrine\ORM\Attributes as ORM;

 /**
  * @ORM\Entity
  */
 class SomeClass
 {
     /**
-     * @var int
+     * @var \Ramsey\Uuid\UuidInterface
      * @ORM\Id
-     * @ORM\Column(type="integer")
-     * @ORM\GeneratedValue(strategy="AUTO")
-     * @Serializer\Type("int")
+     * @ORM\Column(type="uuid_binary")
+     * @Serializer\Type("string")
      */
     public $id;
 }

AddUuidMirrorForRelationPropertyRector

Adds $uuid property to entities, that already have $id with integer type.Require for step-by-step migration from int to uuid.

class: Rector\Doctrine\Rector\Class_\AddUuidMirrorForRelationPropertyRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class SomeEntity
 {
     /**
      * @ORM\ManyToOne(targetEntity="AnotherEntity", cascade={"persist", "merge"})
      * @ORM\JoinColumn(nullable=false)
      */
     private $amenity;
+
+    /**
+     * @ORM\ManyToOne(targetEntity="AnotherEntity", cascade={"persist", "merge"})
+     * @ORM\JoinColumn(nullable=true, referencedColumnName="uuid")
+     */
+    private $amenityUuid;
 }

 /**
  * @ORM\Entity
  */
 class AnotherEntity
 {
     /**
      * @var int
      * @ORM\Id
      * @ORM\Column(type="integer")
      * @ORM\GeneratedValue(strategy="AUTO")
      */
     private $id;

     private $uuid;
 }

AddUuidToEntityWhereMissingRector

Adds $uuid property to entities, that already have $id with integer type.Require for step-by-step migration from int to uuid. In following step it should be renamed to $id and replace it

class: Rector\Doctrine\Rector\Class_\AddUuidToEntityWhereMissingRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class SomeEntityWithIntegerId
 {
     /**
+     * @var \Ramsey\Uuid\UuidInterface
+     * @ORM\Column(type="uuid_binary", unique=true, nullable=true)
+     */
+    private $uuid;
+    /**
      * @var int
      * @ORM\Id
      * @ORM\Column(type="integer")
      * @ORM\GeneratedValue(strategy="AUTO")
      */
     private $id;
 }

AlwaysInitializeUuidInEntityRector

Add uuid initializion to all entities that misses it

class: Rector\Doctrine\Rector\Class_\AlwaysInitializeUuidInEntityRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class AddUuidInit
 {
     /**
      * @ORM\Id
      * @var UuidInterface
      */
     private $superUuid;
+    public function __construct()
+    {
+        $this->superUuid = \Ramsey\Uuid\Uuid::uuid4();
+    }
 }

ChangeGetIdTypeToUuidRector

Change return type of getId() to uuid interface

class: Rector\Doctrine\Rector\ClassMethod\ChangeGetIdTypeToUuidRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class GetId
 {
-    public function getId(): int
+    public function getId(): \Ramsey\Uuid\UuidInterface
     {
         return $this->id;
     }
 }

ChangeGetUuidMethodCallToGetIdRector

Change getUuid() method call to getId()

class: Rector\Doctrine\Rector\MethodCall\ChangeGetUuidMethodCallToGetIdRector

 use Doctrine\ORM\Mapping as ORM;
 use Ramsey\Uuid\Uuid;
 use Ramsey\Uuid\UuidInterface;

 class SomeClass
 {
     public function run()
     {
         $buildingFirst = new Building();

-        return $buildingFirst->getUuid()->toString();
+        return $buildingFirst->getId()->toString();
     }
 }

 /**
  * @ORM\Entity
  */
 class UuidEntity
 {
     private $uuid;
     public function getUuid(): UuidInterface
     {
         return $this->uuid;
     }
 }

ChangeIdenticalUuidToEqualsMethodCallRector

Change $uuid === 1 to $uuid->equals(\Ramsey\Uuid\Uuid::fromString(1))

class: Rector\Doctrine\Rector\Identical\ChangeIdenticalUuidToEqualsMethodCallRector

 class SomeClass
 {
     public function match($checkedId): int
     {
         $building = new Building();

-        return $building->getId() === $checkedId;
+        return $building->getId()->equals(\Ramsey\Uuid\Uuid::fromString($checkedId));
     }
 }

ChangeReturnTypeOfClassMethodWithGetIdRector

Change getUuid() method call to getId()

class: Rector\Doctrine\Rector\ClassMethod\ChangeReturnTypeOfClassMethodWithGetIdRector

 class SomeClass
 {
-    public function getBuildingId(): int
+    public function getBuildingId(): \Ramsey\Uuid\UuidInterface
     {
         $building = new Building();

         return $building->getId();
     }
 }

ChangeSetIdToUuidValueRector

Change set id to uuid values

class: Rector\Doctrine\Rector\MethodCall\ChangeSetIdToUuidValueRector

 use Doctrine\ORM\Mapping as ORM;
 use Ramsey\Uuid\Uuid;

 class SomeClass
 {
     public function run()
     {
         $buildingFirst = new Building();
-        $buildingFirst->setId(1);
-        $buildingFirst->setUuid(Uuid::fromString('a3bfab84-e207-4ddd-b96d-488151de9e96'));
+        $buildingFirst->setId(Uuid::fromString('a3bfab84-e207-4ddd-b96d-488151de9e96'));
     }
 }

 /**
  * @ORM\Entity
  */
 class Building
 {
 }

ChangeSetIdTypeToUuidRector

Change param type of setId() to uuid interface

class: Rector\Doctrine\Rector\ClassMethod\ChangeSetIdTypeToUuidRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class SetId
 {
     private $id;

-    public function setId(int $uuid): int
+    public function setId(\Ramsey\Uuid\UuidInterface $uuid): int
     {
         return $this->id = $uuid;
     }
 }

EntityAliasToClassConstantReferenceRector

Replaces doctrine alias with class.

🔧 configure it!

class: Rector\Doctrine\Rector\MethodCall\EntityAliasToClassConstantReferenceRector

use Rector\Doctrine\Rector\MethodCall\EntityAliasToClassConstantReferenceRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(EntityAliasToClassConstantReferenceRector::class)
        ->call('configure', [[
            EntityAliasToClassConstantReferenceRector::ALIASES_TO_NAMESPACES => [
                App::class => 'App\Entity',
            ],
        ]]);
};

↓

 $entityManager = new Doctrine\ORM\EntityManager();
-$entityManager->getRepository("AppBundle:Post");
+$entityManager->getRepository(\App\Entity\Post::class);

ManagerRegistryGetManagerToEntityManagerRector

Changes ManagerRegistry intermediate calls directly to EntityManager calls

class: Rector\Doctrine\Rector\Class_\ManagerRegistryGetManagerToEntityManagerRector

-use Doctrine\Common\Persistence\ManagerRegistry;
+use Doctrine\ORM\EntityManagerInterface;

 class CustomRepository
 {
     /**
-     * @var ManagerRegistry
+     * @var EntityManagerInterface
      */
-    private $managerRegistry;
+    private $entityManager;

-    public function __construct(ManagerRegistry $managerRegistry)
+    public function __construct(EntityManagerInterface $entityManager)
     {
-        $this->managerRegistry = $managerRegistry;
+        $this->entityManager = $entityManager;
     }

     public function run()
     {
-        $entityManager = $this->managerRegistry->getManager();
-        $someRepository = $entityManager->getRepository('Some');
+        $someRepository = $this->entityManager->getRepository('Some');
     }
 }

RemoveRepositoryFromEntityAnnotationRector

Removes repository class from @Entity annotation

class: Rector\Doctrine\Rector\Class_\RemoveRepositoryFromEntityAnnotationRector

 use Doctrine\ORM\Mapping as ORM;

 /**
- * @ORM\Entity(repositoryClass="ProductRepository")
+ * @ORM\Entity
  */
 class Product
 {
 }

RemoveTemporaryUuidColumnPropertyRector

Remove temporary $uuid property

class: Rector\Doctrine\Rector\Property\RemoveTemporaryUuidColumnPropertyRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class Column
 {
     /**
      * @ORM\Column
      */
     public $id;
-
-    /**
-     * @ORM\Column
-     */
-    public $uuid;
 }

RemoveTemporaryUuidRelationPropertyRector

Remove temporary *Uuid relation properties

class: Rector\Doctrine\Rector\Property\RemoveTemporaryUuidRelationPropertyRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class Column
 {
     /**
      * @ORM\ManyToMany(targetEntity="Phonenumber")
      */
     private $apple;
-
-    /**
-     * @ORM\ManyToMany(targetEntity="Phonenumber")
-     */
-    private $appleUuid;
 }

ServiceEntityRepositoryParentCallToDIRector

Change ServiceEntityRepository to dependency injection, with repository property

class: Rector\Doctrine\Rector\ClassMethod\ServiceEntityRepositoryParentCallToDIRector

 use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
 use Doctrine\Persistence\ManagerRegistry;

 final class ProjectRepository extends ServiceEntityRepository
 {
-    public function __construct(ManagerRegistry $registry)
+    /**
+     * @var \Doctrine\ORM\EntityManagerInterface
+     */
+    private $entityManager;
+
+    /**
+     * @var \Doctrine\ORM\EntityRepository<Project>
+     */
+    private $repository;
+
+    public function __construct(\Doctrine\ORM\EntityManagerInterface $entityManager)
     {
-        parent::__construct($registry, Project::class);
+        $this->repository = $entityManager->getRepository(Project::class);
+        $this->entityManager = $entityManager;
     }
 }

DoctrineCodeQuality

ChangeBigIntEntityPropertyToIntTypeRector

Change database type "bigint" for @var/type declaration to string

class: Rector\DoctrineCodeQuality\Rector\Property\ChangeBigIntEntityPropertyToIntTypeRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity()
  */
 class SomeEntity
 {
     /**
-     * @var int|null
+     * @var string|null
      * @ORM\Column(type="bigint", nullable=true)
      */
     private $bigNumber;
 }

ChangeSetParametersArrayToArrayCollectionRector

Change array to ArrayCollection in setParameters method of query builder

class: Rector\DoctrineCodeQuality\Rector\MethodCall\ChangeSetParametersArrayToArrayCollectionRector

+use Doctrine\Common\Collections\ArrayCollection;
 use Doctrine\ORM\EntityRepository;
+use Doctrine\ORM\Query\Parameter;

 class SomeRepository extends EntityRepository
 {
     public function getSomething()
     {
         return $this
             ->createQueryBuilder('sm')
             ->select('sm')
             ->where('sm.foo = :bar')
-            ->setParameters([
-                'bar' => 'baz'
-            ])
+            ->setParameters(new ArrayCollection([
+                new  Parameter('bar', 'baz'),
+            ]))
             ->getQuery()
             ->getResult()
         ;
     }
 }

CorrectDefaultTypesOnEntityPropertyRector

Change default value types to match Doctrine annotation type

class: Rector\DoctrineCodeQuality\Rector\Property\CorrectDefaultTypesOnEntityPropertyRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity()
  */
 class User
 {
     /**
      * @ORM\Column(name="is_old", type="boolean")
      */
-    private $isOld = '0';
+    private $isOld = false;
 }

ImproveDoctrineCollectionDocTypeInEntityRector

Improve @var, @param and @return types for Doctrine collections to make them useful both for PHPStan and PHPStorm

class: Rector\DoctrineCodeQuality\Rector\Property\ImproveDoctrineCollectionDocTypeInEntityRector

 use Doctrine\Common\Collections\Collection;
 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class SomeClass
 {
     /**
      * @ORM\OneToMany(targetEntity=Training::class, mappedBy="trainer")
-     * @var Collection|Trainer[]
+     * @var Collection<int, Training>|Trainer[]
      */
     private $trainings = [];
 }

InitializeDefaultEntityCollectionRector

Initialize collection property in Entity constructor

class: Rector\DoctrineCodeQuality\Rector\Class_\InitializeDefaultEntityCollectionRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class SomeClass
 {
     /**
      * @ORM\OneToMany(targetEntity="MarketingEvent")
      */
     private $marketingEvents = [];
+
+    public function __construct()
+    {
+        $this->marketingEvents = new ArrayCollection();
+    }
 }

MakeEntityDateTimePropertyDateTimeInterfaceRector

Make maker bundle generate DateTime property accept DateTimeInterface too

class: Rector\DoctrineCodeQuality\Rector\ClassMethod\MakeEntityDateTimePropertyDateTimeInterfaceRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity()
  */
 class User
 {
     /**
-     * @var DateTime|null
+     * @var DateTimeInterface|null
      */
     private $bornAt;

     public function setBornAt(DateTimeInterface $bornAt)
     {
         $this->bornAt = $bornAt;
     }
 }

MakeEntitySetterNullabilityInSyncWithPropertyRector

Make nullability in setter class method with respect to property

class: Rector\DoctrineCodeQuality\Rector\ClassMethod\MakeEntitySetterNullabilityInSyncWithPropertyRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity()
  */
 class Product
 {
     /**
      * @ORM\ManyToOne(targetEntity="AnotherEntity")
      */
     private $anotherEntity;

-    public function setAnotherEntity(?AnotherEntity $anotherEntity)
+    public function setAnotherEntity(AnotherEntity $anotherEntity)
     {
         $this->anotherEntity = $anotherEntity;
     }
 }

MoveCurrentDateTimeDefaultInEntityToConstructorRector

Move default value for entity property to constructor, the safest place

class: Rector\DoctrineCodeQuality\Rector\Class_\MoveCurrentDateTimeDefaultInEntityToConstructorRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity()
  */
 class User
 {
     /**
      * @var DateTimeInterface
      *
-     * @ORM\Column(type="datetime", nullable=false, options={"default"="now()"})
+     * @ORM\Column(type="datetime", nullable=false)
      */
-    private $when = 'now()';
+    private $when;
+
+    public function __construct()
+    {
+        $this->when = new \DateTime();
+    }
 }

MoveRepositoryFromParentToConstructorRector

Turns parent EntityRepository class to constructor dependency

class: Rector\DoctrineCodeQuality\Rector\Class_\MoveRepositoryFromParentToConstructorRector

 namespace App\Repository;

+use App\Entity\Post;
 use Doctrine\ORM\EntityRepository;

-final class PostRepository extends EntityRepository
+final class PostRepository
 {
+    /**
+     * @var \Doctrine\ORM\EntityRepository
+     */
+    private $repository;
+    public function __construct(\Doctrine\ORM\EntityManager $entityManager)
+    {
+        $this->repository = $entityManager->getRepository(\App\Entity\Post::class);
+    }
 }

RemoveRedundantDefaultClassAnnotationValuesRector

Removes redundant default values from Doctrine ORM annotations on class level

class: Rector\DoctrineCodeQuality\Rector\Class_\RemoveRedundantDefaultClassAnnotationValuesRector

 use Doctrine\ORM\Mapping as ORM;

 /**
- * @ORM\Entity(readOnly=false)
+ * @ORM\Entity()
  */
 class SomeClass
 {
 }

RemoveRedundantDefaultPropertyAnnotationValuesRector

Removes redundant default values from Doctrine ORM annotations on class property level

class: Rector\DoctrineCodeQuality\Rector\Property\RemoveRedundantDefaultPropertyAnnotationValuesRector

 use Doctrine\ORM\Mapping as ORM;

 /**
  * @ORM\Entity
  */
 class SomeClass
 {
     /**
      * @ORM\ManyToOne(targetEntity=Training::class)
-     * @ORM\JoinColumn(name="training", unique=false)
+     * @ORM\JoinColumn(name="training")
      */
     private $training;
 }

DoctrineGedmoToKnplabs

BlameableBehaviorRector

Change Blameable from gedmo/doctrine-extensions to knplabs/doctrine-behaviors

class: Rector\DoctrineGedmoToKnplabs\Rector\Class_\BlameableBehaviorRector

-use Gedmo\Mapping\Annotation as Gedmo;
 use Doctrine\ORM\Mapping as ORM;
+use Knp\DoctrineBehaviors\Contract\Entity\BlameableInterface;
+use Knp\DoctrineBehaviors\Model\Blameable\BlameableTrait;

 /**
  * @ORM\Entity
  */
-class SomeClass
+class SomeClass implements BlameableInterface
 {
-    /**
-     * @Gedmo\Blameable(on="create")
-     */
-    private $createdBy;
-
-    /**
-     * @Gedmo\Blameable(on="update")
-     */
-    private $updatedBy;
-
-    /**
-     * @Gedmo\Blameable(on="change", field={"title", "body"})
-     */
-    private $contentChangedBy;
-
-    public function getCreatedBy()
-    {
-        return $this->createdBy;
-    }
-
-    public function getUpdatedBy()
-    {
-        return $this->updatedBy;
-    }
-
-    public function getContentChangedBy()
-    {
-        return $this->contentChangedBy;
-    }
+    use BlameableTrait;
 }

LoggableBehaviorRector

Change Loggable from gedmo/doctrine-extensions to knplabs/doctrine-behaviors

class: Rector\DoctrineGedmoToKnplabs\Rector\Class_\LoggableBehaviorRector

-use Gedmo\Mapping\Annotation as Gedmo;
 use Doctrine\ORM\Mapping as ORM;
+use Knp\DoctrineBehaviors\Model\Loggable\LoggableTrait;
+use Knp\DoctrineBehaviors\Contract\Entity\LoggableInterface;

 /**
  * @ORM\Entity
- * @Gedmo\Loggable
  */
-class SomeClass
+class SomeClass implements LoggableInterface
 {
+    use LoggableTrait;
+
     /**
-     * @Gedmo\Versioned
      * @ORM\Column(name="title", type="string", length=8)
      */
     private $title;
 }

SluggableBehaviorRector

Change Sluggable from gedmo/doctrine-extensions to knplabs/doctrine-behaviors

class: Rector\DoctrineGedmoToKnplabs\Rector\Class_\SluggableBehaviorRector

 use Gedmo\Mapping\Annotation as Gedmo;
+use Knp\DoctrineBehaviors\Model\Sluggable\SluggableTrait;
+use Knp\DoctrineBehaviors\Contract\Entity\SluggableInterface;

-class SomeClass
+class SomeClass implements SluggableInterface
 {
+    use SluggableTrait;
+
     /**
-     * @Gedmo\Slug(fields={"name"})
+     * @return string[]
      */
-    private $slug;
-
-    public function getSlug(): ?string
+    public function getSluggableFields(): array
     {
-        return $this->slug;
-    }
-
-    public function setSlug(?string $slug): void
-    {
-        $this->slug = $slug;
+        return ['name'];
     }
 }

SoftDeletableBehaviorRector

Change SoftDeletable from gedmo/doctrine-extensions to knplabs/doctrine-behaviors

class: Rector\DoctrineGedmoToKnplabs\Rector\Class_\SoftDeletableBehaviorRector

-use Gedmo\Mapping\Annotation as Gedmo;
+use Knp\DoctrineBehaviors\Contract\Entity\SoftDeletableInterface;
+use Knp\DoctrineBehaviors\Model\SoftDeletable\SoftDeletableTrait;

-/**
- * @Gedmo\SoftDeleteable(fieldName="deletedAt", timeAware=false, hardDelete=true)
- */
-class SomeClass
+class SomeClass implements SoftDeletableInterface
 {
-    /**
-     * @ORM\Column(name="deletedAt", type="datetime", nullable=true)
-     */
-    private $deletedAt;
-
-    public function getDeletedAt()
-    {
-        return $this->deletedAt;
-    }
-
-    public function setDeletedAt($deletedAt)
-    {
-        $this->deletedAt = $deletedAt;
-    }
+    use SoftDeletableTrait;
 }

TimestampableBehaviorRector

Change Timestampable from gedmo/doctrine-extensions to knplabs/doctrine-behaviors

class: Rector\DoctrineGedmoToKnplabs\Rector\Class_\TimestampableBehaviorRector

-use Gedmo\Timestampable\Traits\TimestampableEntity;
+use Knp\DoctrineBehaviors\Model\Timestampable\TimestampableTrait;
+use Knp\DoctrineBehaviors\Contract\Entity\TimestampableInterface;

-class SomeClass
+class SomeClass implements TimestampableInterface
 {
-    use TimestampableEntity;
+    use TimestampableTrait;
 }

TranslationBehaviorRector

Change Translation from gedmo/doctrine-extensions to knplabs/doctrine-behaviors

class: Rector\DoctrineGedmoToKnplabs\Rector\Class_\TranslationBehaviorRector

-use Gedmo\Mapping\Annotation as Gedmo;
-use Doctrine\ORM\Mapping as ORM;
-use Gedmo\Translatable\Translatable;
+use Knp\DoctrineBehaviors\Model\Translatable\TranslatableTrait;
+use Knp\DoctrineBehaviors\Contract\Entity\TranslatableInterface;

-/**
- * @ORM\Table
- */
-class Article implements Translatable
+class SomeClass implements TranslatableInterface
 {
+    use TranslatableTrait;
+}
+
+
+use Knp\DoctrineBehaviors\Contract\Entity\TranslationInterface;
+use Knp\DoctrineBehaviors\Model\Translatable\TranslationTrait;
+
+class SomeClassTranslation implements TranslationInterface
+{
+    use TranslationTrait;
+
     /**
-     * @Gedmo\Translatable
      * @ORM\Column(length=128)
      */
     private $title;

     /**
-     * @Gedmo\Translatable
      * @ORM\Column(type="text")
      */
     private $content;
-
-    /**
-     * @Gedmo\Locale
-     * Used locale to override Translation listener`s locale
-     * this is not a mapped field of entity metadata, just a simple property
-     * and it is not necessary because globally locale can be set in listener
-     */
-    private $locale;
-
-    public function setTitle($title)
-    {
-        $this->title = $title;
-    }
-
-    public function getTitle()
-    {
-        return $this->title;
-    }
-
-    public function setContent($content)
-    {
-        $this->content = $content;
-    }
-
-    public function getContent()
-    {
-        return $this->content;
-    }
-
-    public function setTranslatableLocale($locale)
-    {
-        $this->locale = $locale;
-    }
 }

TreeBehaviorRector

Change Tree from gedmo/doctrine-extensions to knplabs/doctrine-behaviors

class: Rector\DoctrineGedmoToKnplabs\Rector\Class_\TreeBehaviorRector

-use Doctrine\Common\Collections\Collection;
-use Gedmo\Mapping\Annotation as Gedmo;
+use Knp\DoctrineBehaviors\Contract\Entity\TreeNodeInterface;
+use Knp\DoctrineBehaviors\Model\Tree\TreeNodeTrait;

-/**
- * @Gedmo\Tree(type="nested")
- */
-class SomeClass
+class SomeClass implements TreeNodeInterface
 {
-    /**
-     * @Gedmo\TreeLeft
-     * @ORM\Column(name="lft", type="integer")
-     * @var int
-     */
-    private $lft;
-
-    /**
-     * @Gedmo\TreeRight
-     * @ORM\Column(name="rgt", type="integer")
-     * @var int
-     */
-    private $rgt;
-
-    /**
-     * @Gedmo\TreeLevel
-     * @ORM\Column(name="lvl", type="integer")
-     * @var int
-     */
-    private $lvl;
-
-    /**
-     * @Gedmo\TreeRoot
-     * @ORM\ManyToOne(targetEntity="Category")
-     * @ORM\JoinColumn(name="tree_root", referencedColumnName="id", onDelete="CASCADE")
-     * @var Category
-     */
-    private $root;
-
-    /**
-     * @Gedmo\TreeParent
-     * @ORM\ManyToOne(targetEntity="Category", inversedBy="children")
-     * @ORM\JoinColumn(name="parent_id", referencedColumnName="id", onDelete="CASCADE")
-     * @var Category
-     */
-    private $parent;
-
-    /**
-     * @ORM\OneToMany(targetEntity="Category", mappedBy="parent")
-     * @var Category[]|Collection
-     */
-    private $children;
-
-    public function getRoot(): self
-    {
-        return $this->root;
-    }
-
-    public function setParent(self $category): void
-    {
-        $this->parent = $category;
-    }
-
-    public function getParent(): self
-    {
-        return $this->parent;
-    }
+    use TreeNodeTrait;
 }

DowngradePhp70

DowngradeTypeParamDeclarationRector

Remove the type params, add @param tags instead

class: Rector\DowngradePhp70\Rector\FunctionLike\DowngradeTypeParamDeclarationRector

 class SomeClass
 {
-    public function run(string $input)
+    /**
+     * @param string $input
+     */
+    public function run($input)
     {
         // do something
     }
 }

DowngradeTypeReturnDeclarationRector

Remove returning types, add a @return tag instead

class: Rector\DowngradePhp70\Rector\FunctionLike\DowngradeTypeReturnDeclarationRector

 class SomeClass
 {
-    public function getResponse(): string
+    /**
+     * @return string
+     */
+    public function getResponse()
     {
         return 'Hello world';
     }
 }

DowngradePhp71

DowngradeClassConstantVisibilityRector

Downgrade class constant visibility

class: Rector\DowngradePhp71\Rector\ClassConst\DowngradeClassConstantVisibilityRector

 class SomeClass
 {
-   public const PUBLIC_CONST_B = 2;
-   protected const PROTECTED_CONST = 3;
-   private const PRIVATE_CONST = 4;
+   const PUBLIC_CONST_B = 2;
+   const PROTECTED_CONST = 3;
+   const PRIVATE_CONST = 4;
 }

DowngradeIterablePseudoTypeParamDeclarationRector

Remove the iterable pseudo type params, add @param tags instead

class: Rector\DowngradePhp71\Rector\FunctionLike\DowngradeIterablePseudoTypeParamDeclarationRector

 class SomeClass
 {
-    public function run(iterable $iterator)
+    /**
+     * @param mixed[]|\Traversable $iterator
+     */
+    public function run($iterator)
     {
         // do something
     }
 }

DowngradeIterablePseudoTypeReturnDeclarationRector

Remove returning iterable pseud type, add a @return tag instead

class: Rector\DowngradePhp71\Rector\FunctionLike\DowngradeIterablePseudoTypeReturnDeclarationRector

 class SomeClass
 {
-    public function run(): iterable
+    /**
+     * @return mixed[]|\Traversable
+     */
+    public function run()
     {
         // do something
     }
 }

DowngradeNegativeStringOffsetToStrlenRector

Downgrade negative string offset to strlen

class: Rector\DowngradePhp71\Rector\String_\DowngradeNegativeStringOffsetToStrlenRector

-echo 'abcdef'[-2];
-echo strpos('aabbcc', 'b', -3);
-echo strpos($var, 'b', -3);
+echo 'abcdef'[strlen('abcdef') - 2];
+echo strpos('aabbcc', 'b', strlen('aabbcc') - 3);
+echo strpos($var, 'b', strlen($var) - 3);

DowngradeNullableTypeParamDeclarationRector

Remove the nullable type params, add @param tags instead

class: Rector\DowngradePhp71\Rector\FunctionLike\DowngradeNullableTypeParamDeclarationRector

 class SomeClass
 {
-    public function run(?string $input)
+    /**
+     * @param string|null $input
+     */
+    public function run($input)
     {
         // do something
     }
 }

DowngradeNullableTypeReturnDeclarationRector

Remove returning nullable types, add a @return tag instead

class: Rector\DowngradePhp71\Rector\FunctionLike\DowngradeNullableTypeReturnDeclarationRector

 class SomeClass
 {
-    public function getResponseOrNothing(bool $flag): ?string
+    /**
+     * @return string|null
+     */
+    public function getResponseOrNothing(bool $flag)
     {
         if ($flag) {
             return 'Hello world';
         }
         return null;
     }
 }

DowngradePipeToMultiCatchExceptionRector

Downgrade single one | separated to multi catch exception

class: Rector\DowngradePhp71\Rector\TryCatch\DowngradePipeToMultiCatchExceptionRector

 try {
     // Some code...
- } catch (ExceptionType1 | ExceptionType2 $exception) {
+} catch (ExceptionType1 $exception) {
     $sameCode;
- }
+} catch (ExceptionType2 $exception) {
+    $sameCode;
+}

DowngradeVoidTypeReturnDeclarationRector

Remove "void" return type, add a "@return void" tag instead

class: Rector\DowngradePhp71\Rector\FunctionLike\DowngradeVoidTypeReturnDeclarationRector

 class SomeClass
 {
-    public function run(): void
+    /**
+     * @return void
+     */
+    public function run()
     {
     }
 }

SymmetricArrayDestructuringToListRector

Downgrade Symmetric array destructuring to list() function

class: Rector\DowngradePhp71\Rector\Array_\SymmetricArrayDestructuringToListRector

-[$id1, $name1] = $data;
+list($id1, $name1) = $data;

DowngradePhp72

DowngradeParamObjectTypeDeclarationRector

Remove the 'PHPStan\Type\ObjectWithoutClassType' param type, add a @param tag instead

class: Rector\DowngradePhp72\Rector\FunctionLike\DowngradeParamObjectTypeDeclarationRector

 class SomeClass
 {
-    public function someFunction(object $someObject)
+    /**
+     * @param object $someObject
+     */
+    public function someFunction($someObject)
     {
     }
 }

DowngradeParameterTypeWideningRector

Remove argument type declarations in the parent and in all child classes, whenever some child class removes it

class: Rector\DowngradePhp72\Rector\ClassMethod\DowngradeParameterTypeWideningRector

 interface A
 {
-    public function test(array $input);
+    /**
+     * @param array $input
+     */
+    public function test($input);
 }

 class B implements A
 {
     public function test($input){} // type omitted for $input
 }

 class C implements A
 {
-    public function test(array $input){}
+    /**
+     * @param array $input
+     */
+    public function test($input);
 }

DowngradeReturnObjectTypeDeclarationRector

Remove "object" return type, add a "@return object" tag instead

class: Rector\DowngradePhp72\Rector\FunctionLike\DowngradeReturnObjectTypeDeclarationRector

 class SomeClass
 {
-    public function getSomeObject(): object
+    /**
+     * @return object
+     */
+    public function getSomeObject()
     {
         return new SomeObject();
     }
 }

DowngradePhp73

DowngradeFlexibleHeredocSyntaxRector

Changes heredoc/nowdoc that contains closing word to safe wrapper name

class: Rector\DowngradePhp73\Rector\String_\DowngradeFlexibleHeredocSyntaxRector

 $query = <<<SQL
-    SELECT *
-    FROM `table`
-    WHERE `column` = true;
-    SQL;
+SELECT *
+FROM `table`
+WHERE `column` = true;
+SQL;

DowngradeListReferenceAssignmentRector

Convert the list reference assignment to its equivalent PHP 7.2 code

class: Rector\DowngradePhp73\Rector\List_\DowngradeListReferenceAssignmentRector

 class SomeClass
 {
     public function run($string)
     {
-        $array = [1, 2, 3];
-        list($a, &$b) = $array;
+        $array = [1, 2];
+        list($a) = $array;
+        $b =& $array[1];

-        [&$c, $d, &$e] = $array;
+        [$c, $d, $e] = $array;
+        $c =& $array[0];
+        $e =& $array[2];

-        list(&$a, &$b) = $array;
+        $a =& $array[0];
+        $b =& $array[1];
     }
 }

DowngradeTrailingCommasInFunctionCallsRector

Remove trailing commas in function calls

class: Rector\DowngradePhp73\Rector\FuncCall\DowngradeTrailingCommasInFunctionCallsRector

 class SomeClass
 {
     public function __construct(string $value)
     {
         $compacted = compact(
             'posts',
-            'units',
+            'units'
         );
     }
 }

SetCookieOptionsArrayToArgumentsRector

Convert setcookie option array to arguments

class: Rector\DowngradePhp73\Rector\FuncCall\SetCookieOptionsArrayToArgumentsRector

-setcookie('name', $value, ['expires' => 360]);
+setcookie('name', $value, 360);

DowngradePhp74

ArrowFunctionToAnonymousFunctionRector

Replace arrow functions with anonymous functions

class: Rector\DowngradePhp74\Rector\ArrowFunction\ArrowFunctionToAnonymousFunctionRector

 class SomeClass
 {
     public function run()
     {
         $delimiter = ",";
-        $callable = fn($matches) => $delimiter . strtolower($matches[1]);
+        $callable = function ($matches) use ($delimiter) {
+            return $delimiter . strtolower($matches[1]);
+        };
     }
 }

DowngradeArrayMergeCallWithoutArgumentsRector

Add missing param to array_merge and array_merge_recursive

class: Rector\DowngradePhp74\Rector\FuncCall\DowngradeArrayMergeCallWithoutArgumentsRector

 class SomeClass
 {
     public function run()
     {
-        array_merge();
-        array_merge_recursive();
+        array_merge([]);
+        array_merge_recursive([]);
     }
 }

DowngradeArraySpreadRector

Replace array spread with array_merge function

class: Rector\DowngradePhp74\Rector\Array_\DowngradeArraySpreadRector

 class SomeClass
 {
     public function run()
     {
         $parts = ['apple', 'pear'];
-        $fruits = ['banana', 'orange', ...$parts, 'watermelon'];
+        $fruits = array_merge(['banana', 'orange'], $parts, ['watermelon']);
     }

     public function runWithIterable()
     {
-        $fruits = ['banana', 'orange', ...new ArrayIterator(['durian', 'kiwi']), 'watermelon'];
+        $item0Unpacked = new ArrayIterator(['durian', 'kiwi']);
+        $fruits = array_merge(['banana', 'orange'], is_array($item0Unpacked) ? $item0Unpacked : iterator_to_array($item0Unpacked), ['watermelon']);
     }
 }

DowngradeContravariantArgumentTypeRector

Remove contravariant argument type declarations

class: Rector\DowngradePhp74\Rector\ClassMethod\DowngradeContravariantArgumentTypeRector

 class ParentType {}
 class ChildType extends ParentType {}

 class A
 {
     public function contraVariantArguments(ChildType $type)
     { /* … */ }
 }

 class B extends A
 {
-    public function contraVariantArguments(ParentType $type)
+    /**
+     * @param ParentType $type
+     */
+    public function contraVariantArguments($type)
     { /* … */ }
 }

DowngradeCovariantReturnTypeRector

Make method return same type as parent

class: Rector\DowngradePhp74\Rector\ClassMethod\DowngradeCovariantReturnTypeRector

 class ParentType {}
 class ChildType extends ParentType {}

 class A
 {
     public function covariantReturnTypes(): ParentType
     { /* … */ }
 }

 class B extends A
 {
-    public function covariantReturnTypes(): ChildType
+    /**
+     * @return ChildType
+     */
+    public function covariantReturnTypes(): ParentType
     { /* … */ }
 }

DowngradeFreadFwriteFalsyToNegationRector

Changes fread() or fwrite() compare to false to negation check

class: Rector\DowngradePhp74\Rector\Identical\DowngradeFreadFwriteFalsyToNegationRector

-fread($handle, $length) === false;
-fwrite($fp, '1') === false;
+!fread($handle, $length);
+!fwrite($fp, '1');

DowngradeNullCoalescingOperatorRector

Remove null coalescing operator ??=

class: Rector\DowngradePhp74\Rector\Coalesce\DowngradeNullCoalescingOperatorRector

 $array = [];
-$array['user_id'] ??= 'value';
+$array['user_id'] = $array['user_id'] ?? 'value';

DowngradeNumericLiteralSeparatorRector

Remove "_" as thousands separator in numbers

class: Rector\DowngradePhp74\Rector\LNumber\DowngradeNumericLiteralSeparatorRector

 class SomeClass
 {
     public function run()
     {
-        $int = 1_000;
-        $float = 1_000_500.001;
+        $int = 1000;
+        $float = 1000500.001;
     }
 }

DowngradeReturnSelfTypeDeclarationRector

Remove "self" return type, add a "@return self" tag instead

class: Rector\DowngradePhp74\Rector\ClassMethod\DowngradeReturnSelfTypeDeclarationRector

 class A
 {
-    public function foo(): self
+    public function foo()
     {
         return $this;
     }
 }

DowngradeStripTagsCallWithArrayRector

Convert 2nd param to strip_tags from array to string

class: Rector\DowngradePhp74\Rector\FuncCall\DowngradeStripTagsCallWithArrayRector

 class SomeClass
 {
     public function run($string)
     {
         // Arrays: change to string
-        strip_tags($string, ['a', 'p']);
+        strip_tags($string, '<' . implode('><', ['a', 'p']) . '>');

         // Variables/consts/properties: if array, change to string
         $tags = ['a', 'p'];
-        strip_tags($string, $tags);
+        strip_tags($string, $tags !== null && is_array($tags) ? '<' . implode('><', $tags) . '>' : $tags);

         // Default case (eg: function call): externalize to var, then if array, change to string
-        strip_tags($string, getTags());
+        $expr = getTags();
+        strip_tags($string, is_array($expr) ? '<' . implode('><', $expr) . '>' : $expr);
     }
 }

DowngradeTypedPropertyRector

Changes property type definition from type definitions to @var annotations.

class: Rector\DowngradePhp74\Rector\Property\DowngradeTypedPropertyRector

 class SomeClass
 {
-    private string $property;
+    /**
+    * @var string
+    */
+    private $property;
 }

DowngradePhp80

DowngradeClassOnObjectToGetClassRector

Change $object::class to get_class($object)

class: Rector\DowngradePhp80\Rector\ClassConstFetch\DowngradeClassOnObjectToGetClassRector

 class SomeClass
 {
     public function run($object)
     {
-        return $object::class;
+        return get_class($object);
     }
 }

DowngradeMatchToSwitchRector

Downgrade match() to switch()

class: Rector\DowngradePhp80\Rector\Expression\DowngradeMatchToSwitchRector

 class SomeClass
 {
     public function run()
     {
-        $message = match ($statusCode) {
-            200, 300 => null,
-            400 => 'not found',
-            default => 'unknown status code',
-        };
+        switch ($statusCode) {
+            case 200:
+            case 300:
+                $message = null;
+                break;
+            case 400:
+                $message = 'not found';
+                break;
+            default:
+                $message = 'unknown status code';
+                break;
+        }
     }
 }

DowngradeNonCapturingCatchesRector

Downgrade catch () without variable to one

class: Rector\DowngradePhp80\Rector\Catch_\DowngradeNonCapturingCatchesRector

 class SomeClass
 {
     public function run()
     {
         try {
             // code
-        } catch (\Exception) {
+        } catch (\Exception $exception) {
             // error
         }
     }
 }

DowngradeNullsafeToTernaryOperatorRector

Change nullsafe operator to ternary operator rector

class: Rector\DowngradePhp80\Rector\NullsafeMethodCall\DowngradeNullsafeToTernaryOperatorRector

-$dateAsString = $booking->getStartDate()?->asDateTimeString();
-$dateAsString = $booking->startDate?->dateTimeString;
+$dateAsString = $booking->getStartDate() ? $booking->getStartDate()->asDateTimeString() : null;
+$dateAsString = $booking->startDate ? $booking->startDate->dateTimeString : null;

DowngradeParamMixedTypeDeclarationRector

Remove the 'PHPStan\Type\MixedType' param type, add a @param tag instead

class: Rector\DowngradePhp80\Rector\FunctionLike\DowngradeParamMixedTypeDeclarationRector

 class SomeClass
 {
-    public function someFunction(mixed $anything)
+    /**
+     * @param mixed $anything
+     */
+    public function someFunction($anything)
     {
     }
 }

DowngradePropertyPromotionRector

Change constructor property promotion to property asssign

class: Rector\DowngradePhp80\Rector\Class_\DowngradePropertyPromotionRector

 class SomeClass
 {
-    public function __construct(public float $value = 0.0)
+    public float $value;
+
+    public function __construct(float $value = 0.0)
     {
+        $this->value = $value;
     }
 }

DowngradeReturnMixedTypeDeclarationRector

Remove "mixed" return type, add a "@return mixed" tag instead

class: Rector\DowngradePhp80\Rector\FunctionLike\DowngradeReturnMixedTypeDeclarationRector

 class SomeClass
 {
-    public function getAnything(bool $flag): mixed
+    /**
+     * @return mixed
+     */
+    public function getAnything(bool $flag)
     {
         if ($flag) {
             return 1;
         }
         return 'Hello world'
     }
 }

DowngradeReturnStaticTypeDeclarationRector

Remove "static" return type, add a "@return $this" tag instead

class: Rector\DowngradePhp80\Rector\FunctionLike\DowngradeReturnStaticTypeDeclarationRector

 class SomeClass
 {
-    public function getStatic(): static
+    /**
+     * @return static
+     */
+    public function getStatic()
     {
         return new static();
     }
 }

DowngradeTrailingCommasInParamUseRector

Remove trailing commas in param or use list

class: Rector\DowngradePhp80\Rector\ClassMethod\DowngradeTrailingCommasInParamUseRector

 class SomeClass
 {
-    public function __construct(string $value1, string $value2,)
+    public function __construct(string $value1, string $value2)
     {
-        function (string $value1, string $value2,) {
+        function (string $value1, string $value2) {
         };

-        function () use ($value1, $value2,) {
+        function () use ($value1, $value2) {
         };
     }
 }

-function inFunction(string $value1, string $value2,)
+function inFunction(string $value1, string $value2)
 {
 }

DowngradeUnionTypeParamDeclarationRector

Remove the union type params, add @param tags instead

class: Rector\DowngradePhp80\Rector\FunctionLike\DowngradeUnionTypeParamDeclarationRector

 class SomeClass
 {
-    public function echoInput(string|int $input)
+    /**
+     * @param string|int $input
+     */
+    public function echoInput($input)
     {
         echo $input;
     }
 }

DowngradeUnionTypeReturnDeclarationRector

Remove returning union types, add a @return tag instead

class: Rector\DowngradePhp80\Rector\FunctionLike\DowngradeUnionTypeReturnDeclarationRector

 class SomeClass
 {
-    public function getSomeObject(bool $flag): string|int
+    /**
+     * @return string|int
+     */
+    public function getSomeObject(bool $flag)
     {
         if ($flag) {
             return 1;
         }
         return 'Hello world';
     }
 }

DowngradeUnionTypeTypedPropertyRector

Removes union type property type definition, adding @var annotations instead.

class: Rector\DowngradePhp80\Rector\Property\DowngradeUnionTypeTypedPropertyRector

 class SomeClass
 {
-    private string|int $property;
+    /**
+    * @var string|int
+    */
+    private $property;
 }

EarlyReturn

ChangeAndIfToEarlyReturnRector

Changes if && to early return

class: Rector\EarlyReturn\Rector\If_\ChangeAndIfToEarlyReturnRector

 class SomeClass
 {
     public function canDrive(Car $car)
     {
-        if ($car->hasWheels && $car->hasFuel) {
-            return true;
+        if (!$car->hasWheels) {
+            return false;
         }

-        return false;
+        if (!$car->hasFuel) {
+            return false;
+        }
+
+        return true;
     }
 }

ChangeIfElseValueAssignToEarlyReturnRector

Change if/else value to early return

class: Rector\EarlyReturn\Rector\If_\ChangeIfElseValueAssignToEarlyReturnRector

 class SomeClass
 {
     public function run()
     {
         if ($this->hasDocBlock($tokens, $index)) {
-            $docToken = $tokens[$this->getDocBlockIndex($tokens, $index)];
-        } else {
-            $docToken = null;
+            return $tokens[$this->getDocBlockIndex($tokens, $index)];
         }
-
-        return $docToken;
+        return null;
     }
 }

ChangeNestedForeachIfsToEarlyContinueRector

Change nested ifs to foreach with continue

class: Rector\EarlyReturn\Rector\Foreach_\ChangeNestedForeachIfsToEarlyContinueRector

 class SomeClass
 {
     public function run()
     {
         $items = [];

         foreach ($values as $value) {
-            if ($value === 5) {
-                if ($value2 === 10) {
-                    $items[] = 'maybe';
-                }
+            if ($value !== 5) {
+                continue;
             }
+            if ($value2 !== 10) {
+                continue;
+            }
+
+            $items[] = 'maybe';
         }
     }
 }

ChangeNestedIfsToEarlyReturnRector

Change nested ifs to early return

class: Rector\EarlyReturn\Rector\If_\ChangeNestedIfsToEarlyReturnRector

 class SomeClass
 {
     public function run()
     {
-        if ($value === 5) {
-            if ($value2 === 10) {
-                return 'yes';
-            }
+        if ($value !== 5) {
+            return 'no';
+        }
+
+        if ($value2 === 10) {
+            return 'yes';
         }

         return 'no';
     }
 }

ChangeOrIfReturnToEarlyReturnRector

Changes if || with return to early return

class: Rector\EarlyReturn\Rector\If_\ChangeOrIfReturnToEarlyReturnRector

 class SomeClass
 {
     public function run($a, $b)
     {
-        if ($a || $b) {
+        if ($a) {
+            return null;
+        }
+        if ($b) {
             return null;
         }

         return 'another';
     }
 }

RemoveAlwaysElseRector

Split if statement, when if condition always break execution flow

class: Rector\EarlyReturn\Rector\If_\RemoveAlwaysElseRector

 class SomeClass
 {
     public function run($value)
     {
         if ($value) {
             throw new \InvalidStateException;
-        } else {
-            return 10;
         }
+
+        return 10;
     }
 }

ReturnBinaryAndToEarlyReturnRector

Changes Single return of && && to early returns

class: Rector\EarlyReturn\Rector\Return_\ReturnBinaryAndToEarlyReturnRector

 class SomeClass
 {
     public function accept($something, $somethingelse)
     {
-        return $something && $somethingelse;
+        if (!$something) {
+            return false;
+        }
+        return (bool) $somethingelse;
     }
 }

FileSystemRector

RemoveProjectFileRector

Remove file relative to project directory

🔧 configure it!

class: Rector\FileSystemRector\Rector\FileNode\RemoveProjectFileRector

use Rector\FileSystemRector\Rector\FileNode\RemoveProjectFileRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(RemoveProjectFileRector::class)
        ->call('configure', [[
            RemoveProjectFileRector::FILE_PATHS_TO_REMOVE => ['someFile/ToBeRemoved.txt'],
        ]]);
};

↓

-// someFile/ToBeRemoved.txt

Generic

ActionInjectionToConstructorInjectionRector

Turns action injection in Controllers to constructor injection

class: Rector\Generic\Rector\Class_\ActionInjectionToConstructorInjectionRector

 final class SomeController
 {
-    public function default(ProductRepository $productRepository)
+    /**
+     * @var ProductRepository
+     */
+    private $productRepository;
+    public function __construct(ProductRepository $productRepository)
     {
-        $products = $productRepository->fetchAll();
+        $this->productRepository = $productRepository;
+    }
+
+    public function default()
+    {
+        $products = $this->productRepository->fetchAll();
     }
 }

AddInterfaceByTraitRector

Add interface by used trait

🔧 configure it!

class: Rector\Generic\Rector\Class_\AddInterfaceByTraitRector

use Rector\Generic\Rector\Class_\AddInterfaceByTraitRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(AddInterfaceByTraitRector::class)
        ->call('configure', [[
            AddInterfaceByTraitRector::INTERFACE_BY_TRAIT => [
                'SomeTrait' => 'SomeInterface',
            ],
        ]]);
};

↓

-class SomeClass
+class SomeClass implements SomeInterface
 {
     use SomeTrait;
 }

AddMethodParentCallRector

Add method parent call, in case new parent method is added

🔧 configure it!

class: Rector\Generic\Rector\ClassMethod\AddMethodParentCallRector

use Rector\Generic\Rector\ClassMethod\AddMethodParentCallRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(AddMethodParentCallRector::class)
        ->call('configure', [[
            AddMethodParentCallRector::METHODS_BY_PARENT_TYPES => [
                'ParentClassWithNewConstructor' => '__construct',
            ],
        ]]);
};

↓

 class SunshineCommand extends ParentClassWithNewConstructor
 {
     public function __construct()
     {
         $value = 5;
+
+        parent::__construct();
     }
 }

AddPropertyByParentRector

Add dependency via constructor by parent class type

🔧 configure it!

class: Rector\Generic\Rector\Class_\AddPropertyByParentRector

use Rector\Generic\Rector\Class_\AddPropertyByParentRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(AddPropertyByParentRector::class)
        ->call('configure', [[
            AddPropertyByParentRector::PARENT_DEPENDENCIES => [
                'SomeParentClass' => ['SomeDependency'],
            ],
        ]]);
};

↓

 final class SomeClass extends SomeParentClass
 {
+    /**
+     * @var SomeDependency
+     */
+    private $someDependency;
+
+    public function __construct(SomeDependency $someDependency)
+    {
+        $this->someDependency = $someDependency;
+    }
 }

AnnotatedPropertyInjectToConstructorInjectionRector

Turns non-private properties with @annotation to private properties and constructor injection

class: Rector\Generic\Rector\Property\AnnotatedPropertyInjectToConstructorInjectionRector

 /**
  * @var SomeService
- * @inject
  */
-public $someService;
+private $someService;
+
+public function __construct(SomeService $someService)
+{
+    $this->someService = $someService;
+}

ArgumentAdderRector

This Rector adds new default arguments in calls of defined methods and class types.

🔧 configure it!

class: Rector\Generic\Rector\ClassMethod\ArgumentAdderRector

use Rector\Generic\Rector\ClassMethod\ArgumentAdderRector;
use Rector\Generic\ValueObject\ArgumentAdder;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ArgumentAdderRector::class)
        ->call('configure', [[
            ArgumentAdderRector::ADDED_ARGUMENTS => ValueObjectInliner::inline([
                new ArgumentAdder('SomeExampleClass', 'someMethod', 0, 'someArgument', 'true', 'SomeType', null),
            ]),
        ]]);
};

↓

 $someObject = new SomeExampleClass;
-$someObject->someMethod();
+$someObject->someMethod(true);

use Rector\Generic\Rector\ClassMethod\ArgumentAdderRector;
use Rector\Generic\ValueObject\ArgumentAdder;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ArgumentAdderRector::class)
        ->call('configure', [[
            ArgumentAdderRector::ADDED_ARGUMENTS => ValueObjectInliner::inline([
                new ArgumentAdder('SomeExampleClass', 'someMethod', 0, 'someArgument', 'true', 'SomeType', null),
            ]),
        ]]);
};

↓

 class MyCustomClass extends SomeExampleClass
 {
-    public function someMethod()
+    public function someMethod($value = true)
     {
     }
 }

ArgumentDefaultValueReplacerRector

Replaces defined map of arguments in defined methods and their calls.

🔧 configure it!

class: Rector\Generic\Rector\ClassMethod\ArgumentDefaultValueReplacerRector

use Rector\Generic\Rector\ClassMethod\ArgumentDefaultValueReplacerRector;
use Rector\Generic\ValueObject\ArgumentDefaultValueReplacer;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ArgumentDefaultValueReplacerRector::class)
        ->call('configure', [[
            ArgumentDefaultValueReplacerRector::REPLACED_ARGUMENTS => ValueObjectInliner::inline([
                new ArgumentDefaultValueReplacer('SomeExampleClass', 'someMethod', 0, 'SomeClass::OLD_CONSTANT', 'false'),
            ]),
        ]]);
};

↓

 $someObject = new SomeClass;
-$someObject->someMethod(SomeClass::OLD_CONSTANT);
+$someObject->someMethod(false);'

ArgumentRemoverRector

Removes defined arguments in defined methods and their calls.

🔧 configure it!

class: Rector\Generic\Rector\ClassMethod\ArgumentRemoverRector

use Rector\Generic\Rector\ClassMethod\ArgumentRemoverRector;
use Rector\Generic\ValueObject\ArgumentRemover;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ArgumentRemoverRector::class)
        ->call('configure', [[
            ArgumentRemoverRector::REMOVED_ARGUMENTS => ValueObjectInliner::inline([
                new ArgumentRemover('ExampleClass', 'someMethod', 0, 'true'),
            ]),
        ]]);
};

↓

 $someObject = new SomeClass;
-$someObject->someMethod(true);
+$someObject->someMethod();'

ChangeConstantVisibilityRector

Change visibility of constant from parent class.

🔧 configure it!

class: Rector\Generic\Rector\ClassConst\ChangeConstantVisibilityRector

use Rector\Generic\Rector\ClassConst\ChangeConstantVisibilityRector;
use Rector\Generic\ValueObject\ClassConstantVisibilityChange;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ChangeConstantVisibilityRector::class)
        ->call('configure', [[
            ChangeConstantVisibilityRector::CLASS_CONSTANT_VISIBILITY_CHANGES => ValueObjectInliner::inline([
                new ClassConstantVisibilityChange('ParentObject', 'SOME_CONSTANT', 2),
            ]),
        ]]);
};

↓

 class FrameworkClass
 {
     protected const SOME_CONSTANT = 1;
 }

 class MyClass extends FrameworkClass
 {
-    public const SOME_CONSTANT = 1;
+    protected const SOME_CONSTANT = 1;
 }

ChangeContractMethodSingleToManyRector

Change method that returns single value to multiple values

🔧 configure it!

class: Rector\Generic\Rector\ClassMethod\ChangeContractMethodSingleToManyRector

use Rector\Generic\Rector\ClassMethod\ChangeContractMethodSingleToManyRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ChangeContractMethodSingleToManyRector::class)
        ->call('configure', [[
            ChangeContractMethodSingleToManyRector::OLD_TO_NEW_METHOD_BY_TYPE => [
                'SomeClass' => [
                    'getNode' => 'getNodes',
                ],
            ],
        ]]);
};

↓

 class SomeClass
 {
-    public function getNode(): string
+    /**
+     * @return string[]
+     */
+    public function getNodes(): array
     {
-        return 'Echo_';
+        return ['Echo_'];
     }
 }

ChangeMethodVisibilityRector

Change visibility of method from parent class.

🔧 configure it!

class: Rector\Generic\Rector\ClassMethod\ChangeMethodVisibilityRector

use Rector\Generic\Rector\ClassMethod\ChangeMethodVisibilityRector;
use Rector\Generic\ValueObject\ChangeMethodVisibility;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ChangeMethodVisibilityRector::class)
        ->call('configure', [[
            ChangeMethodVisibilityRector::METHOD_VISIBILITIES => ValueObjectInliner::inline([
                new ChangeMethodVisibility('FrameworkClass', 'someMethod', 2),
            ]),
        ]]);
};

↓

 class FrameworkClass
 {
     protected someMethod()
     {
     }
 }

 class MyClass extends FrameworkClass
 {
-    public someMethod()
+    protected someMethod()
     {
     }
 }

ChangePropertyVisibilityRector

Change visibility of property from parent class.

🔧 configure it!

class: Rector\Generic\Rector\Property\ChangePropertyVisibilityRector

use Rector\Generic\Rector\Property\ChangePropertyVisibilityRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ChangePropertyVisibilityRector::class)
        ->call('configure', [[
            ChangePropertyVisibilityRector::PROPERTY_TO_VISIBILITY_BY_CLASS => [
                'FrameworkClass' => [
                    'someProperty' => 2,
                ],
            ],
        ]]);
};

↓

 class FrameworkClass
 {
     protected $someProperty;
 }

 class MyClass extends FrameworkClass
 {
-    public $someProperty;
+    protected $someProperty;
 }

DimFetchAssignToMethodCallRector

Change magic array access add to $list, to explicit $list->$addMethod(...)

🔧 configure it!

class: Rector\Generic\Rector\Assign\DimFetchAssignToMethodCallRector

use Rector\Generic\Rector\Assign\DimFetchAssignToMethodCallRector;
use Rector\Generic\ValueObject\DimFetchAssignToMethodCall;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(DimFetchAssignToMethodCallRector::class)
        ->call('configure', [[
            DimFetchAssignToMethodCallRector::DIM_FETCH_ASSIGN_TO_METHOD_CALL => ValueObjectInliner::inline([
                new DimFetchAssignToMethodCall('Nette\Application\Routers\RouteList', 'Nette\Application\Routers\Route', 'addRoute'),
            ]),
        ]]);
};

↓

-use Nette\Application\Routers\Route;
 use Nette\Application\Routers\RouteList;

 class RouterFactory
 {
     public static function createRouter()
     {
         $routeList = new RouteList();
-        $routeList[] = new Route('<module>/<presenter>/<action>[/<id>]', 'Homepage:default');
+        $routeList->addRoute('<module>/<presenter>/<action>[/<id>]', 'Homepage:default');
         return $routeList;
     }
 }

FormerNullableArgumentToScalarTypedRector

Change null in argument, that is now not nullable anymore

class: Rector\Generic\Rector\MethodCall\FormerNullableArgumentToScalarTypedRector

 final class SomeClass
 {
     public function run()
     {
-        $this->setValue(null);
+        $this->setValue('');
     }

     public function setValue(string $value)
     {
     }
 }

FuncCallToNewRector

Change configured function calls to new Instance

🔧 configure it!

class: Rector\Generic\Rector\FuncCall\FuncCallToNewRector

use Rector\Generic\Rector\FuncCall\FuncCallToNewRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(FuncCallToNewRector::class)
        ->call('configure', [[
            FuncCallToNewRector::FUNCTION_TO_NEW => [
                'collection' => ['Collection'],
            ],
        ]]);
};

↓

 class SomeClass
 {
     public function run()
     {
-        $array = collection([]);
+        $array = new \Collection([]);
     }
 }

FuncCallToStaticCallRector

Turns defined function call to static method call.

🔧 configure it!

class: Rector\Generic\Rector\FuncCall\FuncCallToStaticCallRector

use Rector\Generic\Rector\FuncCall\FuncCallToStaticCallRector;
use Rector\Transform\ValueObject\FuncCallToStaticCall;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(FuncCallToStaticCallRector::class)
        ->call('configure', [[
            FuncCallToStaticCallRector::FUNC_CALLS_TO_STATIC_CALLS => ValueObjectInliner::inline([
                new FuncCallToStaticCall('view', 'SomeStaticClass', 'render'),
            ]),
        ]]);
};

↓

-view("...", []);
+SomeClass::render("...", []);

InjectAnnotationClassRector

Changes properties with specified annotations class to constructor injection

🔧 configure it!

class: Rector\Generic\Rector\Property\InjectAnnotationClassRector

use Rector\Generic\Rector\Property\InjectAnnotationClassRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(InjectAnnotationClassRector::class)
        ->call('configure', [[
            InjectAnnotationClassRector::ANNOTATION_CLASSES => [
                'DI\Annotation\Inject',
                'JMS\DiExtraBundle\Annotation\Inject',
            ],
        ]]);
};

↓

 use JMS\DiExtraBundle\Annotation as DI;

 class SomeController
 {
     /**
-     * @DI\Inject("entity.manager")
+     * @var EntityManager
      */
     private $entityManager;
+
+    public function __construct(EntityManager $entityManager)
+    {
+        $this->entityManager = entityManager;
+    }
 }

MergeInterfacesRector

Merges old interface to a new one, that already has its methods

🔧 configure it!

class: Rector\Generic\Rector\Class_\MergeInterfacesRector

use Rector\Generic\Rector\Class_\MergeInterfacesRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(MergeInterfacesRector::class)
        ->call('configure', [[
            MergeInterfacesRector::OLD_TO_NEW_INTERFACES => [
                'SomeOldInterface' => 'SomeInterface',
            ],
        ]]);
};

↓

-class SomeClass implements SomeInterface, SomeOldInterface
+class SomeClass implements SomeInterface
 {
 }

MethodCallRemoverRector

Turns "$this->something()->anything()" to "$this->anything()"

🔧 configure it!

class: Rector\Generic\Rector\MethodCall\MethodCallRemoverRector

use Rector\Generic\Rector\MethodCall\MethodCallRemoverRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(MethodCallRemoverRector::class)
        ->call('configure', [[
            MethodCallRemoverRector::METHOD_CALL_REMOVER_ARGUMENT => [
                '$methodCallRemoverArgument' => [
                    'Car' => 'something',
                ],
            ],
        ]]);
};

↓

 $someObject = new Car;
-$someObject->something()->anything();
+$someObject->anything();

MethodCallToReturnRector

Wrap method call to return

🔧 configure it!

class: Rector\Generic\Rector\Expression\MethodCallToReturnRector

use Rector\Generic\Rector\Expression\MethodCallToReturnRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(MethodCallToReturnRector::class)
        ->call('configure', [[
            MethodCallToReturnRector::METHOD_CALL_WRAPS => [
                'SomeClass' => ['deny'],
            ],
        ]]);
};

↓

 class SomeClass
 {
     public function run()
     {
-        $this->deny();
+        return $this->deny();
     }

     public function deny()
     {
         return 1;
     }
 }

NewObjectToFactoryCreateRector

Replaces creating object instances with "new" keyword with factory method.

🔧 configure it!

class: Rector\Generic\Rector\New_\NewObjectToFactoryCreateRector

use Rector\Generic\Rector\New_\NewObjectToFactoryCreateRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(NewObjectToFactoryCreateRector::class)
        ->call('configure', [[
            NewObjectToFactoryCreateRector::OBJECT_TO_FACTORY_METHOD => [
                'MyClass' => [
                    'class' => 'MyClassFactory',
                    'method' => 'create',
                ],
            ],
        ]]);
};

↓

 class SomeClass
 {
+	/**
+	 * @var \MyClassFactory
+	 */
+	private $myClassFactory;
+
 	public function example() {
-		new MyClass($argument);
+		$this->myClassFactory->create($argument);
 	}
 }

NormalToFluentRector

Turns fluent interface calls to classic ones.

🔧 configure it!

class: Rector\Generic\Rector\ClassMethod\NormalToFluentRector

use Rector\Generic\Rector\ClassMethod\NormalToFluentRector;
use Rector\Generic\ValueObject\NormalToFluent;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(NormalToFluentRector::class)
        ->call('configure', [[
            NormalToFluentRector::CALLS_TO_FLUENT => ValueObjectInliner::inline([
                new NormalToFluent('SomeClass', ['someFunction', 'otherFunction']), ]
            ),
        ]]);
};

↓

 $someObject = new SomeClass();
-$someObject->someFunction();
-$someObject->otherFunction();
+$someObject->someFunction()
+    ->otherFunction();

ParentClassToTraitsRector

Replaces parent class to specific traits

🔧 configure it!

class: Rector\Generic\Rector\Class_\ParentClassToTraitsRector

use Rector\Generic\Rector\Class_\ParentClassToTraitsRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ParentClassToTraitsRector::class)
        ->call('configure', [[
            ParentClassToTraitsRector::PARENT_CLASS_TO_TRAITS => [
                'Nette\Object' => ['Nette\SmartObject'],
            ],
        ]]);
};

↓

-class SomeClass extends Nette\Object
+class SomeClass
 {
+    use Nette\SmartObject;
 }

RemoveAnnotationRector

Remove annotation by names

🔧 configure it!

class: Rector\Generic\Rector\ClassLike\RemoveAnnotationRector

use Rector\Generic\Rector\ClassLike\RemoveAnnotationRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(RemoveAnnotationRector::class)
        ->call('configure', [[
            RemoveAnnotationRector::ANNOTATIONS_TO_REMOVE => ['method'],
        ]]);
};

↓

-/**
- * @method getName()
- */
 final class SomeClass
 {
 }

RemoveFuncCallArgRector

Remove argument by position by function name

🔧 configure it!

class: Rector\Generic\Rector\FuncCall\RemoveFuncCallArgRector

use Rector\Generic\Rector\FuncCall\RemoveFuncCallArgRector;
use Rector\Generic\ValueObject\RemoveFuncCallArg;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(RemoveFuncCallArgRector::class)
        ->call('configure', [[
            RemoveFuncCallArgRector::REMOVED_FUNCTION_ARGUMENTS => ValueObjectInliner::inline([
                new RemoveFuncCallArg('remove_last_arg', 1),
            ]),
        ]]);
};

↓

-remove_last_arg(1, 2);
+remove_last_arg(1);

RemoveIniGetSetFuncCallRector

Remove ini_get by configuration

🔧 configure it!

class: Rector\Generic\Rector\FuncCall\RemoveIniGetSetFuncCallRector

use Rector\Generic\Rector\FuncCall\RemoveIniGetSetFuncCallRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(RemoveIniGetSetFuncCallRector::class)
        ->call('configure', [[
            RemoveIniGetSetFuncCallRector::KEYS_TO_REMOVE => ['y2k_compliance'],
        ]]);
};

↓

-ini_get('y2k_compliance');
-ini_set('y2k_compliance', 1);

RemoveInterfacesRector

Removes interfaces usage from class.

🔧 configure it!

class: Rector\Generic\Rector\Class_\RemoveInterfacesRector

use Rector\Generic\Rector\Class_\RemoveInterfacesRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(RemoveInterfacesRector::class)
        ->call('configure', [[
            RemoveInterfacesRector::INTERFACES_TO_REMOVE => ['SomeInterface'],
        ]]);
};

↓

-class SomeClass implements SomeInterface
+class SomeClass
 {
 }

RemoveParentRector

Removes extends class by name

🔧 configure it!

class: Rector\Generic\Rector\Class_\RemoveParentRector

use Rector\Generic\Rector\Class_\RemoveParentRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(RemoveParentRector::class)
        ->call('configure', [[
            RemoveParentRector::PARENT_TYPES_TO_REMOVE => ['SomeParentClass'],
        ]]);
};

↓

-final class SomeClass extends SomeParentClass
+final class SomeClass
 {
 }

RemoveTraitRector

Remove specific traits from code

🔧 configure it!

class: Rector\Generic\Rector\Class_\RemoveTraitRector

use Rector\Generic\Rector\Class_\RemoveTraitRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(RemoveTraitRector::class)
        ->call('configure', [[
            RemoveTraitRector::TRAITS_TO_REMOVE => ['TraitNameToRemove'],
        ]]);
};

↓

 class SomeClass
 {
-    use SomeTrait;
 }

RenameClassConstantsUseToStringsRector

Replaces constant by value

🔧 configure it!

class: Rector\Generic\Rector\ClassConstFetch\RenameClassConstantsUseToStringsRector

use Rector\Generic\Rector\ClassConstFetch\RenameClassConstantsUseToStringsRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(RenameClassConstantsUseToStringsRector::class)
        ->call('configure', [[
            RenameClassConstantsUseToStringsRector::CLASS_CONST_FETCHES_TO_VALUES => [
                'Nette\Configurator' => [
                    'DEVELOPMENT' => 'development',
                    'PRODUCTION' => 'production',
                ],
            ],
        ]]);
};

↓

-$value === Nette\Configurator::DEVELOPMENT
+$value === "development"

ReplaceVariableByPropertyFetchRector

Turns variable in controller action to property fetch, as follow up to action injection variable to property change.

class: Rector\Generic\Rector\Variable\ReplaceVariableByPropertyFetchRector

 final class SomeController
 {
     /**
      * @var ProductRepository
      */
     private $productRepository;

     public function __construct(ProductRepository $productRepository)
     {
         $this->productRepository = $productRepository;
     }

     public function default()
     {
-        $products = $productRepository->fetchAll();
+        $products = $this->productRepository->fetchAll();
     }
 }

StringToClassConstantRector

Changes strings to specific constants

🔧 configure it!

class: Rector\Generic\Rector\String_\StringToClassConstantRector

use Rector\Generic\Rector\String_\StringToClassConstantRector;
use Rector\Generic\ValueObject\StringToClassConstant;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(StringToClassConstantRector::class)
        ->call('configure', [[
            StringToClassConstantRector::STRINGS_TO_CLASS_CONSTANTS => ValueObjectInliner::inline([
                new StringToClassConstant('compiler.post_dump', 'Yet\AnotherClass', 'CONSTANT'),
            ]),
        ]]);
};

↓

 final class SomeSubscriber
 {
     public static function getSubscribedEvents()
     {
-        return ['compiler.post_dump' => 'compile'];
+        return [\Yet\AnotherClass::CONSTANT => 'compile'];
     }
 }

SwapClassMethodArgumentsRector

Reorder class method arguments, including their calls

🔧 configure it!

class: Rector\Generic\Rector\StaticCall\SwapClassMethodArgumentsRector

use Rector\Generic\Rector\StaticCall\SwapClassMethodArgumentsRector;
use Rector\Generic\ValueObject\SwapClassMethodArguments;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(SwapClassMethodArgumentsRector::class)
        ->call('configure', [[
            SwapClassMethodArgumentsRector::ARGUMENT_SWAPS => ValueObjectInliner::inline([
                new SwapClassMethodArguments('SomeClass', 'run', [1, 0]), ]
            ),
        ]]);
};

↓

 class SomeClass
 {
-    public static function run($first, $second)
+    public static function run($second, $first)
     {
-        self::run($first, $second);
+        self::run($second, $first);
     }
 }

SwapFuncCallArgumentsRector

Swap arguments in function calls

🔧 configure it!

class: Rector\Generic\Rector\FuncCall\SwapFuncCallArgumentsRector

use Rector\Generic\Rector\FuncCall\SwapFuncCallArgumentsRector;
use Rector\Generic\ValueObject\SwapFuncCallArguments;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(SwapFuncCallArgumentsRector::class)
        ->call('configure', [[
            SwapFuncCallArgumentsRector::FUNCTION_ARGUMENT_SWAPS => ValueObjectInliner::inline([
                new SwapFuncCallArguments('some_function', [1, 0]), ]
            ),
        ]]);
};

↓

 final class SomeClass
 {
     public function run($one, $two)
     {
-        return some_function($one, $two);
+        return some_function($two, $one);
     }
 }

WrapReturnRector

Wrap return value of specific method

🔧 configure it!

class: Rector\Generic\Rector\ClassMethod\WrapReturnRector

use Rector\Generic\Rector\ClassMethod\WrapReturnRector;
use Rector\Generic\ValueObject\WrapReturn;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(WrapReturnRector::class)
        ->call('configure', [[
            WrapReturnRector::TYPE_METHOD_WRAPS => ValueObjectInliner::inline([new WrapReturn('SomeClass', 'getItem', true)]),
        ]]);
};

↓

 final class SomeClass
 {
     public function getItem()
     {
-        return 1;
+        return [1];
     }
 }

Laravel

AddGuardToLoginEventRector

Add new $guard argument to Illuminate\Auth\Events\Login

class: Rector\Laravel\Rector\New_\AddGuardToLoginEventRector

 use Illuminate\Auth\Events\Login;

 final class SomeClass
 {
     public function run(): void
     {
-        $loginEvent = new Login('user', false);
+        $guard = config('auth.defaults.guard');
+        $loginEvent = new Login($guard, 'user', false);
     }
 }

AddMockConsoleOutputFalseToConsoleTestsRector

Add "$this->mockConsoleOutput = false"; to console tests that work with output content

class: Rector\Laravel\Rector\Class_\AddMockConsoleOutputFalseToConsoleTestsRector

 use Illuminate\Support\Facades\Artisan;
 use Illuminate\Foundation\Testing\TestCase;

 final class SomeTest extends TestCase
 {
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        $this->mockConsoleOutput = false;
+    }
+
     public function test(): void
     {
         $this->assertEquals('content', \trim((new Artisan())::output()));
     }
 }

AddParentBootToModelClassMethodRector

Add parent::boot(); call to boot() class method in child of Illuminate\Database\Eloquent\Model

class: Rector\Laravel\Rector\ClassMethod\AddParentBootToModelClassMethodRector

 use Illuminate\Database\Eloquent\Model;

 class Product extends Model
 {
     public function boot()
     {
+        parent::boot();
     }
 }

CallOnAppArrayAccessToStandaloneAssignRector

Replace magical call on $this->app["something"] to standalone type assign variable

class: Rector\Laravel\Rector\Assign\CallOnAppArrayAccessToStandaloneAssignRector

 class SomeClass
 {
     /**
      * @var \Illuminate\Contracts\Foundation\Application
      */
     private $app;

     public function run()
     {
-        $validator = $this->app['validator']->make('...');
+        /** @var \Illuminate\Validation\Factory $validationFactory */
+        $validationFactory = $this->app['validator'];
+        $validator = $validationFactory->make('...');
     }
 }

ChangeQueryWhereDateValueWithCarbonRector

Add parent::boot(); call to boot() class method in child of Illuminate\Database\Eloquent\Model

class: Rector\Laravel\Rector\MethodCall\ChangeQueryWhereDateValueWithCarbonRector

 use Illuminate\Database\Query\Builder;

 final class SomeClass
 {
     public function run(Builder $query)
     {
-        $query->whereDate('created_at', '<', Carbon::now());
+        $dateTime = Carbon::now();
+        $query->whereDate('created_at', '<=', $dateTime);
+        $query->whereTime('created_at', '<=', $dateTime);
     }
 }

HelperFuncCallToFacadeClassRector

Change app() func calls to facade calls

class: Rector\Laravel\Rector\FuncCall\HelperFuncCallToFacadeClassRector

 class SomeClass
 {
     public function run()
     {
-        return app('translator')->trans('value');
+        return \Illuminate\Support\Facades\App::get('translator')->trans('value');
     }
 }

MakeTaggedPassedToParameterIterableTypeRector

Change param type to iterable, if passed one

class: Rector\Laravel\Rector\New_\MakeTaggedPassedToParameterIterableTypeRector

 class AnotherClass
 {
     /**
      * @var \Illuminate\Contracts\Foundation\Application
      */
     private $app;

     public function create()
     {
         $tagged = $this->app->tagged('some_tagged');
         return new SomeClass($tagged);
     }
 }

 class SomeClass
 {
-    public function __construct(array $items)
+    public function __construct(iterable $items)
     {
     }
 }

MinutesToSecondsInCacheRector

Change minutes argument to seconds in Illuminate\Contracts\Cache\Store and Illuminate\Support\Facades\Cache

class: Rector\Laravel\Rector\StaticCall\MinutesToSecondsInCacheRector

 class SomeClass
 {
     public function run()
     {
-        Illuminate\Support\Facades\Cache::put('key', 'value', 60);
+        Illuminate\Support\Facades\Cache::put('key', 'value', 60 * 60);
     }
 }

PropertyDeferToDeferrableProviderToRector

Change deprecated $defer = true; to Illuminate\Contracts\Support\DeferrableProvider interface

class: Rector\Laravel\Rector\Class_\PropertyDeferToDeferrableProviderToRector

 use Illuminate\Support\ServiceProvider;
+use Illuminate\Contracts\Support\DeferrableProvider;

-final class SomeServiceProvider extends ServiceProvider
+final class SomeServiceProvider extends ServiceProvider implements DeferrableProvider
 {
-    /**
-     * @var bool
-     */
-    protected $defer = true;
 }

Redirect301ToPermanentRedirectRector

Change "redirect" call with 301 to "permanentRedirect"

class: Rector\Laravel\Rector\StaticCall\Redirect301ToPermanentRedirectRector

 class SomeClass
 {
     public function run()
     {
-        Illuminate\Routing\Route::redirect('/foo', '/bar', 301);
+        Illuminate\Routing\Route::permanentRedirect('/foo', '/bar');
     }
 }

RequestStaticValidateToInjectRector

Change static validate() method to $request->validate()

class: Rector\Laravel\Rector\StaticCall\RequestStaticValidateToInjectRector

 use Illuminate\Http\Request;

 class SomeClass
 {
-    public function store()
+    public function store(\Illuminate\Http\Request $request)
     {
-        $validatedData = Request::validate(['some_attribute' => 'required']);
+        $validatedData = $request->validate(['some_attribute' => 'required']);
     }
 }

Legacy

AddTopIncludeRector

Adds an include file at the top of matching files, except class definitions

🔧 configure it!

class: Rector\Legacy\Rector\FileWithoutNamespace\AddTopIncludeRector

use Rector\Legacy\Rector\FileWithoutNamespace\AddTopIncludeRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(AddTopIncludeRector::class)
        ->call('configure', [[
            AddTopIncludeRector::AUTOLOAD_FILE_PATH => '/../autoloader.php',
            AddTopIncludeRector::PATTERNS => ['pat*/*/?ame.php', 'somepath/?ame.php'],
        ]]);
};

↓

+require_once __DIR__ . '/../autoloader.php';
+
 if (isset($_POST['csrf'])) {
     processPost($_POST);
 }

ChangeSingletonToServiceRector

Change singleton class to normal class that can be registered as a service

class: Rector\Legacy\Rector\Class_\ChangeSingletonToServiceRector

 class SomeClass
 {
-    private static $instance;
-
-    private function __construct()
+    public function __construct()
     {
-    }
-
-    public static function getInstance()
-    {
-        if (null === static::$instance) {
-            static::$instance = new static();
-        }
-
-        return static::$instance;
     }
 }

FunctionToStaticMethodRector

Change functions to static calls, so composer can autoload them

class: Rector\Legacy\Rector\FileWithoutNamespace\FunctionToStaticMethodRector

-function some_function()
+class SomeUtilsClass
 {
+    public static function someFunction()
+    {
+    }
 }

-some_function('lol');
+SomeUtilsClass::someFunction('lol');

RemoveIncludeRector

Remove includes (include, include_once, require, require_once) from source

class: Rector\Legacy\Rector\Include_\RemoveIncludeRector

-include 'somefile.php';

MagicDisclosure

GetAndSetToMethodCallRector

Turns defined __get/__set to specific method calls.

🔧 configure it!

class: Rector\MagicDisclosure\Rector\Assign\GetAndSetToMethodCallRector

use Rector\MagicDisclosure\Rector\Assign\GetAndSetToMethodCallRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(GetAndSetToMethodCallRector::class)
        ->call('configure', [[
            GetAndSetToMethodCallRector::TYPE_TO_METHOD_CALLS => [
                'SomeContainer' => [
                    'set' => 'addService',
                ],
            ],
        ]]);
};

↓

 $container = new SomeContainer;
-$container->someService = $someService;
+$container->setService("someService", $someService);

use Rector\MagicDisclosure\Rector\Assign\GetAndSetToMethodCallRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(GetAndSetToMethodCallRector::class)
        ->call('configure', [[
            GetAndSetToMethodCallRector::TYPE_TO_METHOD_CALLS => [
                'SomeContainer' => [
                    'get' => 'getService',
                ],
            ],
        ]]);
};

↓

 $container = new SomeContainer;
-$someService = $container->someService;
+$someService = $container->getService("someService");

ToStringToMethodCallRector

Turns defined code uses of "__toString()" method to specific method calls.

🔧 configure it!

class: Rector\MagicDisclosure\Rector\String_\ToStringToMethodCallRector

use Rector\MagicDisclosure\Rector\String_\ToStringToMethodCallRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ToStringToMethodCallRector::class)
        ->call('configure', [[
            ToStringToMethodCallRector::METHOD_NAMES_BY_TYPE => [
                'SomeObject' => 'getPath',
            ],
        ]]);
};

↓

 $someValue = new SomeObject;
-$result = (string) $someValue;
-$result = $someValue->__toString();
+$result = $someValue->getPath();
+$result = $someValue->getPath();

UnsetAndIssetToMethodCallRector

Turns defined __isset/__unset calls to specific method calls.

🔧 configure it!

class: Rector\MagicDisclosure\Rector\Isset_\UnsetAndIssetToMethodCallRector

use Rector\MagicDisclosure\Rector\Isset_\UnsetAndIssetToMethodCallRector;
use Rector\MagicDisclosure\ValueObject\IssetUnsetToMethodCall;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(UnsetAndIssetToMethodCallRector::class)
        ->call('configure', [[
            UnsetAndIssetToMethodCallRector::ISSET_UNSET_TO_METHOD_CALL => ValueObjectInliner::inline([
                new IssetUnsetToMethodCall('SomeContainer', 'hasService', 'removeService'),
            ]),
        ]]);
};

↓

 $container = new SomeContainer;
-isset($container["someKey"]);
+$container->hasService("someKey");

use Rector\MagicDisclosure\Rector\Isset_\UnsetAndIssetToMethodCallRector;
use Rector\MagicDisclosure\ValueObject\IssetUnsetToMethodCall;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(UnsetAndIssetToMethodCallRector::class)
        ->call('configure', [[
            UnsetAndIssetToMethodCallRector::ISSET_UNSET_TO_METHOD_CALL => ValueObjectInliner::inline([
                new IssetUnsetToMethodCall('SomeContainer', 'hasService', 'removeService'),
            ]),
        ]]);
};

↓

 $container = new SomeContainer;
-unset($container["someKey"]);
+$container->removeService("someKey");

MockeryToProphecy

MockeryCloseRemoveRector

Removes mockery close from test classes

class: Rector\MockeryToProphecy\Rector\StaticCall\MockeryCloseRemoveRector

 public function tearDown() : void
 {
-    \Mockery::close();
 }

MockeryCreateMockToProphizeRector

Changes mockery mock creation to Prophesize

class: Rector\MockeryToProphecy\Rector\ClassMethod\MockeryCreateMockToProphizeRector

-$mock = \Mockery::mock('MyClass');
+ $mock = $this->prophesize('MyClass');
+
 $service = new Service();
-$service->injectDependency($mock);
+$service->injectDependency($mock->reveal());

MockistaToMockery

MockeryTearDownRector

Add Mockery::close() in tearDown() method if not yet

class: Rector\MockistaToMockery\Rector\Class_\MockeryTearDownRector

 use PHPUnit\Framework\TestCase;

 class SomeTest extends TestCase
 {
+    protected function tearDown(): void
+    {
+        Mockery::close();
+    }
     public function test()
     {
         $mockUser = mock(User::class);
     }
 }

MockistaMockToMockeryMockRector

Change functions to static calls, so composer can autoload them

class: Rector\MockistaToMockery\Rector\ClassMethod\MockistaMockToMockeryMockRector

 class SomeTest
 {
     public function run()
     {
-        $mockUser = mock(User::class);
-        $mockUser->getId()->once->andReturn(1);
-        $mockUser->freeze();
+        $mockUser = Mockery::mock(User::class);
+        $mockUser->expects()->getId()->once()->andReturn(1);
     }
 }

MysqlToMysqli

MysqlAssignToMysqliRector

Converts more complex mysql functions to mysqli

class: Rector\MysqlToMysqli\Rector\Assign\MysqlAssignToMysqliRector

-$data = mysql_db_name($result, $row);
+mysqli_data_seek($result, $row);
+$fetch = mysql_fetch_row($result);
+$data = $fetch[0];

MysqlFuncCallToMysqliRector

Converts more complex mysql functions to mysqli

class: Rector\MysqlToMysqli\Rector\FuncCall\MysqlFuncCallToMysqliRector

-mysql_drop_db($database);
+mysqli_query('DROP DATABASE ' . $database);

MysqlPConnectToMysqliConnectRector

Replace mysql_pconnect() with mysqli_connect() with host p: prefix

class: Rector\MysqlToMysqli\Rector\FuncCall\MysqlPConnectToMysqliConnectRector

 final class SomeClass
 {
     public function run($host, $username, $password)
     {
-        return mysql_pconnect($host, $username, $password);
+        return mysqli_connect('p:' . $host, $username, $password);
     }
 }

MysqlQueryMysqlErrorWithLinkRector

Add mysql_query and mysql_error with connection

class: Rector\MysqlToMysqli\Rector\FuncCall\MysqlQueryMysqlErrorWithLinkRector

 class SomeClass
 {
     public function run()
     {
         $conn = mysqli_connect('host', 'user', 'pass');

-        mysql_error();
+        mysqli_error($conn);
         $sql = 'SELECT';

-        return mysql_query($sql);
+        return mysqli_query($conn, $sql);
     }
 }

Naming

MakeBoolPropertyRespectIsHasWasMethodNamingRector

Renames property to respect is/has/was method naming

class: Rector\Naming\Rector\Property\MakeBoolPropertyRespectIsHasWasMethodNamingRector

 class SomeClass
 {
-    private $full = false;
+    private $isFull = false;

     public function isFull()
     {
-        return $this->full;
+        return $this->isFull;
     }
+
 }

MakeGetterClassMethodNameStartWithGetRector

Change getter method names to start with get/provide

class: Rector\Naming\Rector\ClassMethod\MakeGetterClassMethodNameStartWithGetRector

 class SomeClass
 {
     /**
      * @var string
      */
     private $name;

-    public function name(): string
+    public function getName(): string
     {
         return $this->name;
     }
 }

MakeIsserClassMethodNameStartWithIsRector

Change is method names to start with is/has/was

class: Rector\Naming\Rector\ClassMethod\MakeIsserClassMethodNameStartWithIsRector

 class SomeClass
 {
     /**
      * @var bool
      */
     private $isActive = false;

-    public function getIsActive()
+    public function isActive()
     {
         return $this->isActive;
     }
 }

RenameForeachValueVariableToMatchMethodCallReturnTypeRector

Renames value variable name in foreach loop to match method type

class: Rector\Naming\Rector\Foreach_\RenameForeachValueVariableToMatchMethodCallReturnTypeRector

 class SomeClass
 {
     public function run()
     {
         $array = [];
-        foreach ($object->getMethods() as $property) {
-            $array[] = $property;
+        foreach ($object->getMethods() as $method) {
+            $array[] = $method;
         }
     }
 }

RenameParamToMatchTypeRector

Rename variable to match new ClassType

class: Rector\Naming\Rector\ClassMethod\RenameParamToMatchTypeRector

 final class SomeClass
 {
-    public function run(Apple $pie)
+    public function run(Apple $apple)
     {
-        $food = $pie;
+        $food = $apple;
     }
 }

RenamePropertyToMatchTypeRector

Rename property and method param to match its type

class: Rector\Naming\Rector\Class_\RenamePropertyToMatchTypeRector

 class SomeClass
 {
     /**
      * @var EntityManager
      */
-    private $eventManager;
+    private $entityManager;

-    public function __construct(EntityManager $eventManager)
+    public function __construct(EntityManager $entityManager)
     {
-        $this->eventManager = $eventManager;
+        $this->entityManager = $entityManager;
     }
 }

RenameVariableToMatchMethodCallReturnTypeRector

Rename variable to match method return type

class: Rector\Naming\Rector\Assign\RenameVariableToMatchMethodCallReturnTypeRector

 class SomeClass
 {
     public function run()
     {
-        $a = $this->getRunner();
+        $runner = $this->getRunner();
     }

     public function getRunner(): Runner
     {
         return new Runner();
     }
 }

RenameVariableToMatchNewTypeRector

Rename variable to match new ClassType

class: Rector\Naming\Rector\ClassMethod\RenameVariableToMatchNewTypeRector

 final class SomeClass
 {
     public function run()
     {
-        $search = new DreamSearch();
-        $search->advance();
+        $dreamSearch = new DreamSearch();
+        $dreamSearch->advance();
     }
 }

UnderscoreToCamelCaseLocalVariableNameRector

Change under_score local variable names to camelCase

class: Rector\Naming\Rector\Variable\UnderscoreToCamelCaseLocalVariableNameRector

 final class SomeClass
 {
     public function run($a_b)
     {
-        $some_value = $a_b;
+        $someValue = $a_b;
     }
 }

UnderscoreToCamelCasePropertyNameRector

Change under_score names to camelCase

class: Rector\Naming\Rector\Property\UnderscoreToCamelCasePropertyNameRector

 final class SomeClass
 {
-    public $property_name;
+    public $propertyName;

     public function run($a)
     {
-        $this->property_name = 5;
+        $this->propertyName = 5;
     }
 }

UnderscoreToCamelCaseVariableNameRector

Change under_score names to camelCase

class: Rector\Naming\Rector\Variable\UnderscoreToCamelCaseVariableNameRector

 final class SomeClass
 {
-    public function run($a_b)
+    public function run($aB)
     {
-        $some_value = $a_b;
+        $someValue = $aB;
     }
 }

Nette

AddNextrasDatePickerToDateControlRector

Nextras/Form upgrade of addDatePicker method call to DateControl assign

class: Rector\Nette\Rector\MethodCall\AddNextrasDatePickerToDateControlRector

 use Nette\Application\UI\Form;

 class SomeClass
 {
     public function run()
     {
         $form = new Form();
-        $form->addDatePicker('key', 'Label');
+        $form['key'] = new \Nextras\FormComponents\Controls\DateControl('Label');
     }
 }

BuilderExpandToHelperExpandRector

Change containerBuilder->expand() to static call with parameters

class: Rector\Nette\Rector\MethodCall\BuilderExpandToHelperExpandRector

 use Nette\DI\CompilerExtension;

 final class SomeClass extends CompilerExtension
 {
     public function loadConfiguration()
     {
-        $value = $this->getContainerBuilder()->expand('%value');
+        $value = \Nette\DI\Helpers::expand('%value', $this->getContainerBuilder()->parameters);
     }
 }

ContextGetByTypeToConstructorInjectionRector

Move dependency get via $context->getByType() to constructor injection

class: Rector\Nette\Rector\MethodCall\ContextGetByTypeToConstructorInjectionRector

 class SomeClass
 {
     /**
      * @var \Nette\DI\Container
      */
     private $context;

+    /**
+     * @var SomeTypeToInject
+     */
+    private $someTypeToInject;
+
+    public function __construct(SomeTypeToInject $someTypeToInject)
+    {
+        $this->someTypeToInject = $someTypeToInject;
+    }
+
     public function run()
     {
-        $someTypeToInject = $this->context->getByType(SomeTypeToInject::class);
+        $someTypeToInject = $this->someTypeToInject;
     }
 }

ConvertAddUploadWithThirdArgumentTrueToAddMultiUploadRector

convert addUpload() with 3rd argument true to addMultiUpload()

class: Rector\Nette\Rector\MethodCall\ConvertAddUploadWithThirdArgumentTrueToAddMultiUploadRector

 $form = new Nette\Forms\Form();
-$form->addUpload('...', '...', true);
+$form->addMultiUpload('...', '...');

EndsWithFunctionToNetteUtilsStringsRector

Use Nette\Utils\Strings::endsWith() over bare string-functions

class: Rector\Nette\Rector\Identical\EndsWithFunctionToNetteUtilsStringsRector

 class SomeClass
 {
     public function end($needle)
     {
         $content = 'Hi, my name is Tom';

-        $yes = substr($content, -strlen($needle)) === $needle;
+        $yes = \Nette\Utils\Strings::endsWith($content, $needle);
     }
 }

FilePutContentsToFileSystemWriteRector

Change file_put_contents() to FileSystem::write()

class: Rector\Nette\Rector\FuncCall\FilePutContentsToFileSystemWriteRector

 class SomeClass
 {
     public function run()
     {
-        file_put_contents('file.txt', 'content');
+        \Nette\Utils\FileSystem::write('file.txt', 'content');

         file_put_contents('file.txt', 'content_to_append', FILE_APPEND);
     }
 }

JsonDecodeEncodeToNetteUtilsJsonDecodeEncodeRector

Changes json_encode()/json_decode() to safer and more verbose Nette\Utils\Json::encode()/decode() calls

class: Rector\Nette\Rector\FuncCall\JsonDecodeEncodeToNetteUtilsJsonDecodeEncodeRector

 class SomeClass
 {
     public function decodeJson(string $jsonString)
     {
-        $stdClass = json_decode($jsonString);
+        $stdClass = \Nette\Utils\Json::decode($jsonString);

-        $array = json_decode($jsonString, true);
-        $array = json_decode($jsonString, false);
+        $array = \Nette\Utils\Json::decode($jsonString, \Nette\Utils\Json::FORCE_ARRAY);
+        $array = \Nette\Utils\Json::decode($jsonString);
     }

     public function encodeJson(array $data)
     {
-        $jsonString = json_encode($data);
+        $jsonString = \Nette\Utils\Json::encode($data);

-        $prettyJsonString = json_encode($data, JSON_PRETTY_PRINT);
+        $prettyJsonString = \Nette\Utils\Json::encode($data, \Nette\Utils\Json::PRETTY);
     }
 }

MagicHtmlCallToAppendAttributeRector

Change magic addClass() etc. calls on Html to explicit methods

class: Rector\Nette\Rector\MethodCall\MagicHtmlCallToAppendAttributeRector

 use Nette\Utils\Html;

 final class SomeClass
 {
     public function run()
     {
         $html = Html::el();
-        $html->setClass('first');
+        $html->appendAttribute('class', 'first');
     }
 }

MergeDefaultsInGetConfigCompilerExtensionRector

Change $this->getConfig($defaults) to array_merge

class: Rector\Nette\Rector\MethodCall\MergeDefaultsInGetConfigCompilerExtensionRector

 use Nette\DI\CompilerExtension;

 final class SomeExtension extends CompilerExtension
 {
     private $defaults = [
         'key' => 'value'
     ];

     public function loadConfiguration()
     {
-        $config = $this->getConfig($this->defaults);
+        $config = array_merge($this->defaults, $this->getConfig());
     }
 }

MoveFinalGetUserToCheckRequirementsClassMethodRector

Presenter method getUser() is now final, move logic to checkRequirements()

class: Rector\Nette\Rector\Class_\MoveFinalGetUserToCheckRequirementsClassMethodRector

 use Nette\Application\UI\Presenter;

 class SomeControl extends Presenter
 {
-    public function getUser()
+    public function checkRequirements()
     {
-        $user = parent::getUser();
+        $user = $this->getUser();
         $user->getStorage()->setNamespace('admin_session');
-        return $user;
+
+        parent::checkRequirements();
     }
 }

PregFunctionToNetteUtilsStringsRector

Use Nette\Utils\Strings over bare preg_split() and preg_replace() functions

class: Rector\Nette\Rector\FuncCall\PregFunctionToNetteUtilsStringsRector

+use Nette\Utils\Strings;
+
 class SomeClass
 {
     public function run()
     {
         $content = 'Hi my name is Tom';
-        $splitted = preg_split('#Hi#', $content);
+        $splitted = \Nette\Utils\Strings::split($content, '#Hi#');
     }
 }

PregMatchFunctionToNetteUtilsStringsRector

Use Nette\Utils\Strings over bare preg_match() and preg_match_all() functions

class: Rector\Nette\Rector\FuncCall\PregMatchFunctionToNetteUtilsStringsRector

+use Nette\Utils\Strings;
+
 class SomeClass
 {
     public function run()
     {
         $content = 'Hi my name is Tom';
-        preg_match('#Hi#', $content, $matches);
+        $matches = Strings::match($content, '#Hi#');
     }
 }

RemoveParentAndNameFromComponentConstructorRector

Remove $parent and $name in control constructor

class: Rector\Nette\Rector\ClassMethod\RemoveParentAndNameFromComponentConstructorRector

 use Nette\Application\UI\Control;

 class SomeControl extends Control
 {
-    public function __construct(IContainer $parent = null, $name = null, int $value)
+    public function __construct(int $value)
     {
-        parent::__construct($parent, $name);
         $this->value = $value;
     }
 }

RequestGetCookieDefaultArgumentToCoalesceRector

Add removed Nette\Http\Request::getCookies() default value as coalesce

class: Rector\Nette\Rector\MethodCall\RequestGetCookieDefaultArgumentToCoalesceRector

 use Nette\Http\Request;

 class SomeClass
 {
     public function run(Request $request)
     {
-        return $request->getCookie('name', 'default');
+        return $request->getCookie('name') ?? 'default';
     }
 }

SetClassWithArgumentToSetFactoryRector

Change setClass with class and arguments to separated methods

class: Rector\Nette\Rector\MethodCall\SetClassWithArgumentToSetFactoryRector

 use Nette\DI\ContainerBuilder;

 class SomeClass
 {
     public function run(ContainerBuilder $containerBuilder)
     {
         $containerBuilder->addDefinition('...')
-            ->setClass('SomeClass', [1, 2]);
+            ->setFactory('SomeClass', [1, 2]);
     }
 }

StartsWithFunctionToNetteUtilsStringsRector

Use Nette\Utils\Strings::startsWith() over bare string-functions

class: Rector\Nette\Rector\Identical\StartsWithFunctionToNetteUtilsStringsRector

 class SomeClass
 {
     public function start($needle)
     {
         $content = 'Hi, my name is Tom';

-        $yes = substr($content, 0, strlen($needle)) === $needle;
+        $yes = \Nette\Utils\Strings::startsWith($content, $needle);
     }
 }

StrposToStringsContainsRector

Use Nette\Utils\Strings over bare string-functions

class: Rector\Nette\Rector\NotIdentical\StrposToStringsContainsRector

 class SomeClass
 {
     public function run()
     {
         $name = 'Hi, my name is Tom';
-        return strpos($name, 'Hi') !== false;
+        return \Nette\Utils\Strings::contains($name, 'Hi');
     }
 }

SubstrStrlenFunctionToNetteUtilsStringsRector

Use Nette\Utils\Strings over bare string-functions

class: Rector\Nette\Rector\FuncCall\SubstrStrlenFunctionToNetteUtilsStringsRector

 class SomeClass
 {
     public function run()
     {
-        return substr($value, 0, 3);
+        return \Nette\Utils\Strings::substring($value, 0, 3);
     }
 }

TemplateMagicAssignToExplicitVariableArrayRector

Change $this->templates->{magic} to $this->template->render(..., $values)

class: Rector\Nette\Rector\ClassMethod\TemplateMagicAssignToExplicitVariableArrayRector

 use Nette\Application\UI\Control;

 class SomeControl extends Control
 {
     public function render()
     {
-        $this->template->param = 'some value';
-        $this->template->render(__DIR__ . '/poll.latte');
+        $this->template->render(__DIR__ . '/poll.latte', ['param' => 'some value']);
     }
 }

TranslateClassMethodToVariadicsRector

Change translate() method call 2nd arg to variadic

class: Rector\Nette\Rector\ClassMethod\TranslateClassMethodToVariadicsRector

 use Nette\Localization\ITranslator;

 final class SomeClass implements ITranslator
 {
-    public function translate($message, $count = null)
+    public function translate($message, ... $parameters)
     {
+        $count = $parameters[0] ?? null;
         return [$message, $count];
     }
 }

NetteCodeQuality

AnnotateMagicalControlArrayAccessRector

Change magic $this["some_component"] to variable assign with @var annotation

class: Rector\NetteCodeQuality\Rector\ArrayDimFetch\AnnotateMagicalControlArrayAccessRector

 use Nette\Application\UI\Presenter;
 use Nette\Application\UI\Form;

 final class SomePresenter extends Presenter
 {
     public function run()
     {
-        if ($this['some_form']->isSubmitted()) {
+        /** @var \Nette\Application\UI\Form $someForm */
+        $someForm = $this['some_form'];
+        if ($someForm->isSubmitted()) {
         }
     }

     protected function createComponentSomeForm()
     {
         return new Form();
     }
 }

ArrayAccessGetControlToGetComponentMethodCallRector

Change magic arrays access get, to explicit $this->getComponent(...) method

class: Rector\NetteCodeQuality\Rector\Assign\ArrayAccessGetControlToGetComponentMethodCallRector

 use Nette\Application\UI\Presenter;

 class SomeClass extends Presenter
 {
     public function some()
     {
-        $someControl = $this['whatever'];
+        $someControl = $this->getComponent('whatever');
     }
 }

ArrayAccessSetControlToAddComponentMethodCallRector

Change magic arrays access set, to explicit $this->setComponent(...) method

class: Rector\NetteCodeQuality\Rector\Assign\ArrayAccessSetControlToAddComponentMethodCallRector

 use Nette\Application\UI\Control;
 use Nette\Application\UI\Presenter;

 class SomeClass extends Presenter
 {
     public function some()
     {
         $someControl = new Control();
-        $this['whatever'] = $someControl;
+        $this->addComponent($someControl, 'whatever');
     }
 }

ChangeFormArrayAccessToAnnotatedControlVariableRector

Change array access magic on $form to explicit standalone typed variable

class: Rector\NetteCodeQuality\Rector\ArrayDimFetch\ChangeFormArrayAccessToAnnotatedControlVariableRector

 use Nette\Application\UI\Form;

 class SomePresenter
 {
     public function run()
     {
         $form = new Form();
         $this->addText('email', 'Email');

-        $form['email']->value = 'hey@hi.hello';
+        /** @var \Nette\Forms\Controls\TextInput $emailControl */
+        $emailControl = $form['email'];
+        $emailControl->value = 'hey@hi.hello';
     }
 }

MakeGetComponentAssignAnnotatedRector

Add doc type for magic $control->getComponent(...) assign

class: Rector\NetteCodeQuality\Rector\Assign\MakeGetComponentAssignAnnotatedRector

 use Nette\Application\UI\Control;

 final class SomeClass
 {
     public function run()
     {
         $externalControl = new ExternalControl();
+        /** @var AnotherControl $anotherControl */
         $anotherControl = $externalControl->getComponent('another');
     }
 }

 final class ExternalControl extends Control
 {
     public function createComponentAnother(): AnotherControl
     {
         return new AnotherControl();
     }
 }

 final class AnotherControl extends Control
 {
 }

MoveInjectToExistingConstructorRector

Move @inject properties to constructor, if there already is one

class: Rector\NetteCodeQuality\Rector\Class_\MoveInjectToExistingConstructorRector

 final class SomeClass
 {
     /**
      * @var SomeDependency
-     * @inject
      */
-    public $someDependency;
+    private $someDependency;

     /**
      * @var OtherDependency
      */
     private $otherDependency;

-    public function __construct(OtherDependency $otherDependency)
+    public function __construct(OtherDependency $otherDependency, SomeDependency $someDependency)
     {
         $this->otherDependency = $otherDependency;
+        $this->someDependency = $someDependency;
     }
 }

SubstrMinusToStringEndsWithRector

Change substr function with minus to Strings::endsWith()

class: Rector\NetteCodeQuality\Rector\Identical\SubstrMinusToStringEndsWithRector

-substr($var, -4) !== 'Test';
-substr($var, -4) === 'Test';
+! \Nette\Utils\Strings::endsWith($var, 'Test');
+\Nette\Utils\Strings::endsWith($var, 'Test');

NetteKdyby

ChangeNetteEventNamesInGetSubscribedEventsRector

Change EventSubscriber from Kdyby to Contributte

class: Rector\NetteKdyby\Rector\ClassMethod\ChangeNetteEventNamesInGetSubscribedEventsRector

+use Contributte\Events\Extra\Event\Application\ShutdownEvent;
 use Kdyby\Events\Subscriber;
 use Nette\Application\Application;
-use Nette\Application\UI\Presenter;

 class GetApplesSubscriber implements Subscriber
 {
-    public function getSubscribedEvents()
+    public static function getSubscribedEvents()
     {
         return [
-            Application::class . '::onShutdown',
+            ShutdownEvent::class => 'onShutdown',
         ];
     }

-    public function onShutdown(Presenter $presenter)
+    public function onShutdown(ShutdownEvent $shutdownEvent)
     {
+        $presenter = $shutdownEvent->getPresenter();
         $presenterName = $presenter->getName();
         // ...
     }
 }

ReplaceEventManagerWithEventSubscriberRector

Change Kdyby EventManager to EventDispatcher

class: Rector\NetteKdyby\Rector\MethodCall\ReplaceEventManagerWithEventSubscriberRector

 use Kdyby\Events\EventManager;

 final class SomeClass
 {
     /**
      * @var EventManager
      */
     private $eventManager;

     public function __construct(EventManager $eventManager)
     {
         $this->eventManager = eventManager;
     }

     public function run()
     {
         $key = '2000';
-        $this->eventManager->dispatchEvent(static::class . '::onCopy', new EventArgsList([$this, $key]));
+        $this->eventManager->dispatch(new SomeClassCopyEvent($this, $key));
     }
 }

ReplaceMagicPropertyEventWithEventClassRector

Change $onProperty magic call with event disptacher and class dispatch

class: Rector\NetteKdyby\Rector\MethodCall\ReplaceMagicPropertyEventWithEventClassRector

 final class FileManager
 {
-    public $onUpload;
+    use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;

+    public function __construct(EventDispatcherInterface $eventDispatcher)
+    {
+        $this->eventDispatcher = $eventDispatcher;
+    }
+
     public function run(User $user)
     {
-        $this->onUpload($user);
+        $onFileManagerUploadEvent = new FileManagerUploadEvent($user);
+        $this->eventDispatcher->dispatch($onFileManagerUploadEvent);
     }
 }

ReplaceMagicPropertyWithEventClassRector

Change getSubscribedEvents() from on magic property, to Event class

class: Rector\NetteKdyby\Rector\ClassMethod\ReplaceMagicPropertyWithEventClassRector

 use Kdyby\Events\Subscriber;

 final class ActionLogEventSubscriber implements Subscriber
 {
     public function getSubscribedEvents(): array
     {
         return [
-            AlbumService::class . '::onApprove' => 'onAlbumApprove',
+            AlbumServiceApproveEvent::class => 'onAlbumApprove',
         ];
     }

-    public function onAlbumApprove(Album $album, int $adminId): void
+    public function onAlbumApprove(AlbumServiceApproveEventAlbum $albumServiceApproveEventAlbum): void
     {
+        $album = $albumServiceApproveEventAlbum->getAlbum();
         $album->play();
     }
 }

NetteTesterToPHPUnit

NetteAssertToPHPUnitAssertRector

Migrate Nette/Assert calls to PHPUnit

class: Rector\NetteTesterToPHPUnit\Rector\StaticCall\NetteAssertToPHPUnitAssertRector

 use Tester\Assert;

 function someStaticFunctions()
 {
-    Assert::true(10 == 5);
+    \PHPUnit\Framework\Assert::assertTrue(10 == 5);
 }

NetteTesterClassToPHPUnitClassRector

Migrate Nette Tester test case to PHPUnit

class: Rector\NetteTesterToPHPUnit\Rector\Class_\NetteTesterClassToPHPUnitClassRector

 namespace KdybyTests\Doctrine;

 use Tester\TestCase;
 use Tester\Assert;

-require_once __DIR__ . '/../bootstrap.php';
-
-class ExtensionTest extends TestCase
+class ExtensionTest extends \PHPUnit\Framework\TestCase
 {
     public function testFunctionality()
     {
-        Assert::true($default instanceof Kdyby\Doctrine\EntityManager);
-        Assert::true(5);
-        Assert::same($container->getService('kdyby.doctrine.default.entityManager'), $default);
+        $this->assertInstanceOf(\Kdyby\Doctrine\EntityManager::cllass, $default);
+        $this->assertTrue(5);
+        $this->same($container->getService('kdyby.doctrine.default.entityManager'), $default);
     }
-}
-
-(new \ExtensionTest())->run();
+}

RenameTesterTestToPHPUnitToTestFileRector

Rename "*.phpt" file to "*Test.php" file

class: Rector\NetteTesterToPHPUnit\Rector\FileNode\RenameTesterTestToPHPUnitToTestFileRector

-// tests/SomeTestCase.phpt
+// tests/SomeTestCase.php

NetteToSymfony

DeleteFactoryInterfaceRector

Interface factories are not needed in Symfony. Clear constructor injection is used instead

class: Rector\NetteToSymfony\Rector\Interface_\DeleteFactoryInterfaceRector

-interface SomeControlFactoryInterface
-{
-    public function create();
-}

FormControlToControllerAndFormTypeRector

Change Form that extends Control to Controller and decoupled FormType

class: Rector\NetteToSymfony\Rector\Class_\FormControlToControllerAndFormTypeRector

-use Nette\Application\UI\Form;
-use Nette\Application\UI\Control;
-
-class SomeForm extends Control
+class SomeFormController extends \Symfony\Bundle\FrameworkBundle\Controller\AbstractController
 {
-    public function createComponentForm()
+    /**
+     * @Route(...)
+     */
+    public function actionSomeForm(\Symfony\Component\HttpFoundation\Request $request): \Symfony\Component\HttpFoundation\Response
     {
-        $form = new Form();
-        $form->addText('name', 'Your name');
+        $form = $this->createForm(SomeFormType::class);
+        $form->handleRequest($request);

-        $form->onSuccess[] = [$this, 'processForm'];
-    }
-
-    public function processForm(Form $form)
-    {
-        // process me
+        if ($form->isSuccess() && $form->isValid()) {
+            // process me
+        }
     }
 }

Extra file:

use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\FormBuilderInterface;

class SomeFormType extends AbstractType
{
    public function buildForm(FormBuilderInterface $formBuilder, array $options)
    {
        $formBuilder->add('name', TextType::class, [
            'label' => 'Your name',
        ]);
    }
}

FromHttpRequestGetHeaderToHeadersGetRector

Changes getHeader() to $request->headers->get()

class: Rector\NetteToSymfony\Rector\MethodCall\FromHttpRequestGetHeaderToHeadersGetRector

 use Nette\Request;

 final class SomeController
 {
     public static function someAction(Request $request)
     {
-        $header = $this->httpRequest->getHeader('x');
+        $header = $request->headers->get('x');
     }
 }

FromRequestGetParameterToAttributesGetRector

Changes "getParameter()" to "attributes->get()" from Nette to Symfony

class: Rector\NetteToSymfony\Rector\MethodCall\FromRequestGetParameterToAttributesGetRector

 use Nette\Request;

 final class SomeController
 {
     public static function someAction(Request $request)
     {
-        $value = $request->getParameter('abz');
+        $value = $request->attribute->get('abz');
     }
 }

NetteControlToSymfonyControllerRector

Migrate Nette Component to Symfony Controller

class: Rector\NetteToSymfony\Rector\Class_\NetteControlToSymfonyControllerRector

-use Nette\Application\UI\Control;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Response;

-class SomeControl extends Control
+class SomeController extends AbstractController
 {
-    public function render()
-    {
-        $this->template->param = 'some value';
-        $this->template->render(__DIR__ . '/poll.latte');
-    }
+     public function some(): Response
+     {
+         return $this->render(__DIR__ . '/poll.latte', ['param' => 'some value']);
+     }
 }

NetteFormToSymfonyFormRector

Migrate Nette\Forms in Presenter to Symfony

class: Rector\NetteToSymfony\Rector\MethodCall\NetteFormToSymfonyFormRector

 use Nette\Application\UI;

 class SomePresenter extends UI\Presenter
 {
     public function someAction()
     {
-        $form = new UI\Form;
-        $form->addText('name', 'Name:');
-        $form->addPassword('password', 'Password:');
-        $form->addSubmit('login', 'Sign up');
+        $form = $this->createFormBuilder();
+        $form->add('name', \Symfony\Component\Form\Extension\Core\Type\TextType::class, [
+            'label' => 'Name:'
+        ]);
+        $form->add('password', \Symfony\Component\Form\Extension\Core\Type\PasswordType::class, [
+            'label' => 'Password:'
+        ]);
+        $form->add('login', \Symfony\Component\Form\Extension\Core\Type\SubmitType::class, [
+            'label' => 'Sign up'
+        ]);
     }
 }

RenameEventNamesInEventSubscriberRector

Changes event names from Nette ones to Symfony ones

class: Rector\NetteToSymfony\Rector\ClassMethod\RenameEventNamesInEventSubscriberRector

 use Symfony\Component\EventDispatcher\EventSubscriberInterface;

 final class SomeClass implements EventSubscriberInterface
 {
     public static function getSubscribedEvents()
     {
-        return ['nette.application' => 'someMethod'];
+        return [\SymfonyEvents::KERNEL => 'someMethod'];
     }
 }

RouterListToControllerAnnotationsRector

Change new Route() from RouteFactory to @Route annotation above controller method

class: Rector\NetteToSymfony\Rector\ClassMethod\RouterListToControllerAnnotationsRector

 final class RouterFactory
 {
     public function create(): RouteList
     {
         $routeList = new RouteList();
+
+        // case of single action controller, usually get() or __invoke() method
         $routeList[] = new Route('some-path', SomePresenter::class);

         return $routeList;
     }
 }

+use Symfony\Component\Routing\Annotation\Route;
+
 final class SomePresenter
 {
+    /**
+     * @Route(path="some-path")
+     */
     public function run()
     {
     }
 }

WrapTransParameterNameRector

Adds %% to placeholder name of trans() method if missing

class: Rector\NetteToSymfony\Rector\MethodCall\WrapTransParameterNameRector

 use Symfony\Component\Translation\Translator;

 final class SomeController
 {
     public function run()
     {
         $translator = new Translator('');
         $translated = $translator->trans(
             'Hello %name%',
-            ['name' => $name]
+            ['%name%' => $name]
         );
     }
 }

NetteUtilsCodeQuality

ReplaceTimeNumberWithDateTimeConstantRector

Replace time numbers with Nette\Utils\DateTime constants

class: Rector\NetteUtilsCodeQuality\Rector\LNumber\ReplaceTimeNumberWithDateTimeConstantRector

 final class SomeClass
 {
     public function run()
     {
-        return 86400;
+        return \Nette\Utils\DateTime::DAY;
     }
 }

Order

OrderClassConstantsByIntegerValueRector

Order class constant order by their integer value

class: Rector\Order\Rector\Class_\OrderClassConstantsByIntegerValueRector

 class SomeClass
 {
     const MODE_ON = 0;

+    const MODE_MAYBE = 1;
+
     const MODE_OFF = 2;
-
-    const MODE_MAYBE = 1;
 }

OrderConstantsByVisibilityRector

Orders constants by visibility

class: Rector\Order\Rector\Class_\OrderConstantsByVisibilityRector

 final class SomeClass
 {
+    public const PUBLIC_CONST = 'public';
+    protected const PROTECTED_CONST = 'protected';
     private const PRIVATE_CONST = 'private';
-    protected const PROTECTED_CONST = 'protected';
-    public const PUBLIC_CONST = 'public';
 }

OrderFirstLevelClassStatementsRector

Orders first level Class statements

class: Rector\Order\Rector\Class_\OrderFirstLevelClassStatementsRector

 final class SomeClass
 {
+    use TraitName;
+    private const CONST_NAME = 'constant_value';
+    protected $propertyName;
     public function functionName();
-    protected $propertyName;
-    private const CONST_NAME = 'constant_value';
-    use TraitName;
 }

OrderMethodsByVisibilityRector

Orders method by visibility

class: Rector\Order\Rector\Class_\OrderMethodsByVisibilityRector

 class SomeClass
 {
+    public function publicFunctionName();
     protected function protectedFunctionName();
     private function privateFunctionName();
-    public function publicFunctionName();
 }

OrderPrivateMethodsByUseRector

Order private methods in order of their use

class: Rector\Order\Rector\Class_\OrderPrivateMethodsByUseRector

 class SomeClass
 {
     public function run()
     {
         $this->call1();
         $this->call2();
     }

-    private function call2()
+    private function call1()
     {
     }

-    private function call1()
+    private function call2()
     {
     }
 }

OrderPropertiesByVisibilityRector

Orders properties by visibility

class: Rector\Order\Rector\Class_\OrderPropertiesByVisibilityRector

 final class SomeClass
 {
+    public $publicProperty;
     protected $protectedProperty;
     private $privateProperty;
-    public $publicProperty;
 }

PHPOffice

AddRemovedDefaultValuesRector

Complete removed default values explicitly

class: Rector\PHPOffice\Rector\StaticCall\AddRemovedDefaultValuesRector

 final class SomeClass
 {
     public function run(): void
     {
         $logger = new \PHPExcel_CalcEngine_Logger;
-        $logger->setWriteDebugLog();
+        $logger->setWriteDebugLog(false);
     }
 }

CellStaticToCoordinateRector

Methods to manipulate coordinates that used to exists in PHPExcel_Cell to PhpOffice\PhpSpreadsheet\Cell\Coordinate

class: Rector\PHPOffice\Rector\StaticCall\CellStaticToCoordinateRector

 class SomeClass
 {
     public function run()
     {
-        \PHPExcel_Cell::stringFromColumnIndex();
+        \PhpOffice\PhpSpreadsheet\Cell\Coordinate::stringFromColumnIndex();
     }
 }

ChangeChartRendererRector

Change chart renderer

class: Rector\PHPOffice\Rector\StaticCall\ChangeChartRendererRector

 final class SomeClass
 {
     public function run(): void
     {
-        \PHPExcel_Settings::setChartRenderer($rendererName, $rendererLibraryPath);
+        \PHPExcel_Settings::setChartRenderer(\PhpOffice\PhpSpreadsheet\Chart\Renderer\JpGraph::class);
     }
 }

ChangeConditionalGetConditionRector

Change argument PHPExcel_Style_Conditional->getCondition() to getConditions()

class: Rector\PHPOffice\Rector\MethodCall\ChangeConditionalGetConditionRector

 final class SomeClass
 {
     public function run(): void
     {
         $conditional = new \PHPExcel_Style_Conditional;
-        $someCondition = $conditional->getCondition();
+        $someCondition = $conditional->getConditions()[0] ?? '';
     }
 }

ChangeConditionalReturnedCellRector

Change conditional call to getCell()

class: Rector\PHPOffice\Rector\MethodCall\ChangeConditionalReturnedCellRector

 final class SomeClass
 {
     public function run(): void
     {
         $worksheet = new \PHPExcel_Worksheet();
-        $cell = $worksheet->setCellValue('A1', 'value', true);
+        $cell = $worksheet->getCell('A1')->setValue('value');
     }
 }

ChangeConditionalSetConditionRector

Change argument PHPExcel_Style_Conditional->setCondition() to setConditions()

class: Rector\PHPOffice\Rector\MethodCall\ChangeConditionalSetConditionRector

 final class SomeClass
 {
     public function run(): void
     {
         $conditional = new \PHPExcel_Style_Conditional;
-        $someCondition = $conditional->setCondition(1);
+        $someCondition = $conditional->setConditions((array) 1);
     }
 }

ChangeDataTypeForValueRector

Change argument DataType::dataTypeForValue() to DefaultValueBinder

class: Rector\PHPOffice\Rector\StaticCall\ChangeDataTypeForValueRector

 final class SomeClass
 {
     public function run(): void
     {
-        $type = \PHPExcel_Cell_DataType::dataTypeForValue('value');
+        $type = \PhpOffice\PhpSpreadsheet\Cell\DefaultValueBinder::dataTypeForValue('value');
     }
 }

ChangeDuplicateStyleArrayToApplyFromArrayRector

Change method call duplicateStyleArray() to getStyle() + applyFromArray()

class: Rector\PHPOffice\Rector\MethodCall\ChangeDuplicateStyleArrayToApplyFromArrayRector

 final class SomeClass
 {
     public function run(): void
     {
         $worksheet = new \PHPExcel_Worksheet();
-        $worksheet->duplicateStyleArray($styles, $range, $advanced);
+        $worksheet->getStyle($range)->applyFromArray($styles, $advanced);
     }
 }

ChangeIOFactoryArgumentRector

Change argument of PHPExcel_IOFactory::createReader(), PHPExcel_IOFactory::createWriter() and PHPExcel_IOFactory::identify()

class: Rector\PHPOffice\Rector\StaticCall\ChangeIOFactoryArgumentRector

 final class SomeClass
 {
     public function run(): void
     {
-        $writer = \PHPExcel_IOFactory::createWriter('CSV');
+        $writer = \PHPExcel_IOFactory::createWriter('Csv');
     }
 }

ChangePdfWriterRector

Change init of PDF writer

class: Rector\PHPOffice\Rector\StaticCall\ChangePdfWriterRector

 final class SomeClass
 {
     public function run(): void
     {
-        \PHPExcel_Settings::setPdfRendererName(PHPExcel_Settings::PDF_RENDERER_MPDF);
-        \PHPExcel_Settings::setPdfRenderer($somePath);
-        $writer = \PHPExcel_IOFactory::createWriter($spreadsheet, 'PDF');
+        $writer = new \PhpOffice\PhpSpreadsheet\Writer\Pdf\Mpdf($spreadsheet);
     }
 }

ChangeSearchLocationToRegisterReaderRector

Change argument addSearchLocation() to registerReader()

class: Rector\PHPOffice\Rector\StaticCall\ChangeSearchLocationToRegisterReaderRector

 final class SomeClass
 {
     public function run(): void
     {
-        \PHPExcel_IOFactory::addSearchLocation($type, $location, $classname);
+        \PhpOffice\PhpSpreadsheet\IOFactory::registerReader($type, $classname);
     }
 }

GetDefaultStyleToGetParentRector

Methods to (new Worksheet())->getDefaultStyle() to getParent()->getDefaultStyle()

class: Rector\PHPOffice\Rector\MethodCall\GetDefaultStyleToGetParentRector

 class SomeClass
 {
     public function run()
     {
         $worksheet = new \PHPExcel_Worksheet();
-        $worksheet->getDefaultStyle();
+        $worksheet->getParent()->getDefaultStyle();
     }
 }

IncreaseColumnIndexRector

Column index changed from 0 to 1 - run only ONCE! changes current value without memory

class: Rector\PHPOffice\Rector\MethodCall\IncreaseColumnIndexRector

 final class SomeClass
 {
     public function run(): void
     {
         $worksheet = new \PHPExcel_Worksheet();
-        $worksheet->setCellValueByColumnAndRow(0, 3, '1150');
+        $worksheet->setCellValueByColumnAndRow(1, 3, '1150');
     }
 }

RemoveSetTempDirOnExcelWriterRector

Remove setTempDir() on PHPExcel_Writer_Excel5

class: Rector\PHPOffice\Rector\MethodCall\RemoveSetTempDirOnExcelWriterRector

 final class SomeClass
 {
     public function run(): void
     {
         $writer = new \PHPExcel_Writer_Excel5;
-        $writer->setTempDir();
     }
 }

PHPUnit

AddDoesNotPerformAssertionToNonAssertingTestRector

Tests without assertion will have @doesNotPerformAssertion

class: Rector\PHPUnit\Rector\ClassMethod\AddDoesNotPerformAssertionToNonAssertingTestRector

 use PHPUnit\Framework\TestCase;

 class SomeClass extends TestCase
 {
+    /**
+     * @doesNotPerformAssertions
+     */
     public function test()
     {
         $nothing = 5;
     }
 }

AddProphecyTraitRector

Add Prophecy trait for method using $this->prophesize()

class: Rector\PHPUnit\Rector\Class_\AddProphecyTraitRector

 use PHPUnit\Framework\TestCase;
+use Prophecy\PhpUnit\ProphecyTrait;

 final class ExampleTest extends TestCase
 {
+    use ProphecyTrait;
+
     public function testOne(): void
     {
         $prophecy = $this->prophesize(\AnInterface::class);
     }
 }

AddSeeTestAnnotationRector

Add @see annotation test of the class for faster jump to test. Make it FQN, so it stays in the annotation, not in the PHP source code.

class: Rector\PHPUnit\Rector\Class_\AddSeeTestAnnotationRector

+/**
+ * @see \SomeServiceTest
+ */
 class SomeService
 {
 }

 use PHPUnit\Framework\TestCase;

 class SomeServiceTest extends TestCase
 {
 }

ArrayArgumentInTestToDataProviderRector

Move array argument from tests into data provider [configurable]

🔧 configure it!

class: Rector\PHPUnit\Rector\Class_\ArrayArgumentInTestToDataProviderRector

use Rector\PHPUnit\Rector\Class_\ArrayArgumentInTestToDataProviderRector;
use Rector\PHPUnit\ValueObject\ArrayArgumentToDataProvider;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\SymfonyPhpConfig\ValueObjectInliner;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ArrayArgumentInTestToDataProviderRector::class)
        ->call('configure', [[
            ArrayArgumentInTestToDataProviderRector::ARRAY_ARGUMENTS_TO_DATA_PROVIDERS => ValueObjectInliner::inline([
                new ArrayArgumentToDataProvider('PHPUnit\Framework\TestCase', 'doTestMultiple', 'doTestSingle', 'number'),
            ]),
        ]]);
};

↓

 use PHPUnit\Framework\TestCase;

 class SomeServiceTest extends TestCase
 {
-    public function test()
+    /**
+     * @dataProvider provideData()
+     */
+    public function test(int $number)
     {
-        $this->doTestMultiple([1, 2, 3]);
+        $this->doTestSingle($number);
+    }
+
+    public function provideData(): \Iterator
+    {
+        yield [1];
+        yield [2];
+        yield [3];
     }
 }

AssertCompareToSpecificMethodRector

Turns vague php-only method in PHPUnit TestCase to more specific

class: Rector\PHPUnit\Rector\MethodCall\AssertCompareToSpecificMethodRector

-$this->assertSame(10, count($anything), "message");
+$this->assertCount(10, $anything, "message");

-$this->assertNotEquals(get_class($value), stdClass::class);
+$this->assertNotInstanceOf(stdClass::class, $value);

AssertComparisonToSpecificMethodRector

Turns comparison operations to their method name alternatives in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertComparisonToSpecificMethodRector

-$this->assertTrue($foo === $bar, "message");
+$this->assertSame($bar, $foo, "message");

-$this->assertFalse($foo >= $bar, "message");
+$this->assertLessThanOrEqual($bar, $foo, "message");

AssertEqualsParameterToSpecificMethodsTypeRector

Change assertEquals()/assertNotEquals() method parameters to new specific alternatives

class: Rector\PHPUnit\Rector\MethodCall\AssertEqualsParameterToSpecificMethodsTypeRector

 final class SomeTest extends \PHPUnit\Framework\TestCase
 {
     public function test()
     {
         $value = 'value';
-        $this->assertEquals('string', $value, 'message', 5.0);
+        $this->assertEqualsWithDelta('string', $value, 5.0, 'message');

-        $this->assertEquals('string', $value, 'message', 0.0, 20);
+        $this->assertEquals('string', $value, 'message', 0.0);

-        $this->assertEquals('string', $value, 'message', 0.0, 10, true);
+        $this->assertEqualsCanonicalizing('string', $value, 'message');

-        $this->assertEquals('string', $value, 'message', 0.0, 10, false, true);
+        $this->assertEqualsIgnoringCase('string', $value, 'message');
     }
 }

AssertEqualsToSameRector

Turns assertEquals() into stricter assertSame() for scalar values in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertEqualsToSameRector

-$this->assertEquals(2, $result, "message");
+$this->assertSame(2, $result, "message");

-$this->assertEquals($aString, $result, "message");
+$this->assertSame($aString, $result, "message");

AssertFalseStrposToContainsRector

Turns strpos/stripos comparisons to their method name alternatives in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertFalseStrposToContainsRector

-$this->assertFalse(strpos($anything, "foo"), "message");
+$this->assertNotContains("foo", $anything, "message");

-$this->assertNotFalse(stripos($anything, "foo"), "message");
+$this->assertContains("foo", $anything, "message");

AssertInstanceOfComparisonRector

Turns instanceof comparisons to their method name alternatives in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertInstanceOfComparisonRector

-$this->assertTrue($foo instanceof Foo, "message");
+$this->assertInstanceOf("Foo", $foo, "message");

-$this->assertFalse($foo instanceof Foo, "message");
+$this->assertNotInstanceOf("Foo", $foo, "message");

AssertIssetToSpecificMethodRector

Turns isset comparisons to their method name alternatives in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertIssetToSpecificMethodRector

-$this->assertTrue(isset($anything->foo));
+$this->assertObjectHasAttribute("foo", $anything);

-$this->assertFalse(isset($anything["foo"]), "message");
+$this->assertArrayNotHasKey("foo", $anything, "message");

AssertNotOperatorRector

Turns not-operator comparisons to their method name alternatives in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertNotOperatorRector

-$this->assertTrue(!$foo, "message");
+$this->assertFalse($foo, "message");

-$this->assertFalse(!$foo, "message");
+$this->assertTrue($foo, "message");

AssertPropertyExistsRector

Turns property_exists comparisons to their method name alternatives in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertPropertyExistsRector

-$this->assertTrue(property_exists(new Class, "property"), "message");
+$this->assertClassHasAttribute("property", "Class", "message");

-$this->assertFalse(property_exists(new Class, "property"), "message");
+$this->assertClassNotHasAttribute("property", "Class", "message");

AssertRegExpRector

Turns preg_match comparisons to their method name alternatives in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertRegExpRector

-$this->assertSame(1, preg_match("/^Message for ".*"\.$/", $string), $message);
+$this->assertRegExp("/^Message for ".*"\.$/", $string, $message);

-$this->assertEquals(false, preg_match("/^Message for ".*"\.$/", $string), $message);
+$this->assertNotRegExp("/^Message for ".*"\.$/", $string, $message);

AssertResourceToClosedResourceRector

Turns assertIsNotResource() into stricter assertIsClosedResource() for resource values in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertResourceToClosedResourceRector

-$this->assertIsNotResource($aResource, "message");
+$this->assertIsClosedResource($aResource, "message");

AssertSameBoolNullToSpecificMethodRector

Turns same bool and null comparisons to their method name alternatives in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertSameBoolNullToSpecificMethodRector

-$this->assertSame(null, $anything);
+$this->assertNull($anything);

-$this->assertNotSame(false, $anything);
+$this->assertNotFalse($anything);

AssertSameTrueFalseToAssertTrueFalseRector

Change $this->assertSame(true, ...) to assertTrue()

class: Rector\PHPUnit\Rector\MethodCall\AssertSameTrueFalseToAssertTrueFalseRector

 use PHPUnit\Framework\TestCase;

 final class SomeTest extends TestCase
 {
     public function test()
     {
         $value = (bool) mt_rand(0, 1);
-        $this->assertSame(true, $value);
+        $this->assertTrue($value);
     }
 }

AssertTrueFalseInternalTypeToSpecificMethodRector

Turns true/false with internal type comparisons to their method name alternatives in PHPUnit TestCase

class: Rector\PHPUnit\Rector\MethodCall\AssertTrueFalseInternalTypeToSpecificMethodRector

-$this->assertTrue(is_{internal_type}($anything), "message");
+$this->assertInternalType({internal_type}, $anything, "message");

-$this->assertFalse(is_{internal_type}($anything), "message");
+$this->assertNotInternalType({internal_type}, $anything, "message");

AssertTrueFalseToSpecificMethodRector

Turns true/false comparisons to their method name alternatives in PHPUnit TestCase when possible

class: Rector\PHPUnit\Rector\MethodCall\AssertTrueFalseToSpecificMethodRector

-$this->assertTrue(is_readable($readmeFile), "message");
+$this->assertIsReadable($readmeFile, "message");

ConstructClassMethodToSetUpTestCaseRector

Change __construct() method in tests of PHPUnit\Framework\TestCase to setUp(), to prevent dangerous override

class: Rector\PHPUnit\Rector\Class_\ConstructClassMethodToSetUpTestCaseRector

 use PHPUnit\Framework\TestCase;

 final class SomeTest extends TestCase
 {
     private $someValue;

-    public function __construct(?string $name = null, array $data = [], string $dataName = '')
+    protected function setUp()
     {
+        parent::setUp();
+
         $this->someValue = 1000;
-        parent::__construct($name, $data, $dataName);
     }
 }

CreateMockToCreateStubRector

Replaces createMock() with createStub() when relevant

class: Rector\PHPUnit\Rector\MethodCall\CreateMockToCreateStubRector

 use PHPUnit\Framework\TestCase

 class MyTest extends TestCase
 {
     public function testItBehavesAsExpected(): void
     {
-        $stub = $this->createMock(\Exception::class);
+        $stub = $this->createStub(\Exception::class);
         $stub->method('getMessage')
             ->willReturn('a message');

         $mock = $this->createMock(\Exception::class);
         $mock->expects($this->once())
             ->method('getMessage')
             ->willReturn('a message');

         self::assertSame('a message', $stub->getMessage());
         self::assertSame('a message', $mock->getMessage());
     }
 }

DelegateExceptionArgumentsRector

Takes setExpectedException() 2nd and next arguments to own methods in PHPUnit.

class: Rector\PHPUnit\Rector\MethodCall\DelegateExceptionArgumentsRector

-$this->setExpectedException(Exception::class, "Message", "CODE");
+$this->setExpectedException(Exception::class);
+$this->expectExceptionMessage('Message');
+$this->expectExceptionCode('CODE');

ExceptionAnnotationRector

Changes ``@expectedExceptionannotations toexpectException*()` methods

class: Rector\PHPUnit\Rector\ClassMethod\ExceptionAnnotationRector

-/**
- * @expectedException Exception
- * @expectedExceptionMessage Message
- */
 public function test()
 {
+    $this->expectException('Exception');
+    $this->expectExceptionMessage('Message');
     // tested code
 }

ExplicitPhpErrorApiRector

Use explicit API for expecting PHP errors, warnings, and notices

class: Rector\PHPUnit\Rector\MethodCall\ExplicitPhpErrorApiRector

 final class SomeTest extends \PHPUnit\Framework\TestCase
 {
     public function test()
     {
-        $this->expectException(\PHPUnit\Framework\TestCase\Deprecated::class);
-        $this->expectException(\PHPUnit\Framework\TestCase\Error::class);
-        $this->expectException(\PHPUnit\Framework\TestCase\Notice::class);
-        $this->expectException(\PHPUnit\Framework\TestCase\Warning::class);
+        $this->expectDeprecation();
+        $this->expectError();
+        $this->expectNotice();
+        $this->expectWarning();
     }
 }

GetMockBuilderGetMockToCreateMockRector

Remove getMockBuilder() to createMock()

class: Rector\PHPUnit\Rector\MethodCall\GetMockBuilderGetMockToCreateMockRector

 class SomeTest extends \PHPUnit\Framework\TestCase
 {
     public function test()
     {
-        $applicationMock = $this->getMockBuilder('SomeClass')
-           ->disableOriginalConstructor()
-           ->getMock();
+        $applicationMock = $this->createMock('SomeClass');
     }
 }

GetMockRector

Turns getMock*() methods to createMock()

class: Rector\PHPUnit\Rector\StaticCall\GetMockRector

-$this->getMock("Class");
+$this->createMock("Class");

-$this->getMockWithoutInvokingTheOriginalConstructor("Class");
+$this->createMock("Class");

RemoveDataProviderTestPrefixRector

Data provider methods cannot start with "test" prefix

class: Rector\PHPUnit\Rector\Class_\RemoveDataProviderTestPrefixRector

 class SomeClass extends PHPUnit\Framework\TestCase
 {
     /**
-     * @dataProvider testProvideData()
+     * @dataProvider provideData()
      */
     public function test()
     {
         $nothing = 5;
     }

-    public function testProvideData()
+    public function provideData()
     {
         return ['123'];
     }
 }

RemoveEmptyTestMethodRector

Remove empty test methods

class: Rector\PHPUnit\Rector\ClassMethod\RemoveEmptyTestMethodRector

 class SomeTest extends \PHPUnit\Framework\TestCase
 {
-    /**
-     * testGetTranslatedModelField method
-     *
-     * @return void
-     */
-    public function testGetTranslatedModelField()
-    {
-    }
 }

RemoveExpectAnyFromMockRector

Remove expect($this->any()) from mocks as it has no added value

class: Rector\PHPUnit\Rector\MethodCall\RemoveExpectAnyFromMockRector

 use PHPUnit\Framework\TestCase;

 class SomeClass extends TestCase
 {
     public function test()
     {
         $translator = $this->getMock('SomeClass');
-        $translator->expects($this->any())
-            ->method('trans')
+        $translator->method('trans')
             ->willReturn('translated max {{ max }}!');
     }
 }

ReplaceAssertArraySubsetWithDmsPolyfillRector

Change assertArraySubset() to static call of DMS\PHPUnitExtensions\ArraySubset\Assert

class: Rector\PHPUnit\Rector\MethodCall\ReplaceAssertArraySubsetWithDmsPolyfillRector

 use PHPUnit\Framework\TestCase;

 class SomeClass extends TestCase
 {
     public function test()
     {
-        self::assertArraySubset(['bar' => 0], ['bar' => '0'], true);
+        \DMS\PHPUnitExtensions\ArraySubset\Assert::assertArraySubset(['bar' => 0], ['bar' => '0'], true);

-        $this->assertArraySubset(['bar' => 0], ['bar' => '0'], true);
+        \DMS\PHPUnitExtensions\ArraySubset\Assert::assertArraySubset(['bar' => 0], ['bar' => '0'], true);
     }
 }

SelfContainerGetMethodCallFromTestToInjectPropertyRector

Change $container->get() calls in PHPUnit to @inject properties autowired by jakzal/phpunit-injector

class: Rector\PHPUnit\Rector\Class_\SelfContainerGetMethodCallFromTestToInjectPropertyRector

 use PHPUnit\Framework\TestCase;
 class SomeClassTest extends TestCase {
+    /**
+     * @var SomeService
+     * @inject
+     */
+    private $someService;
     public function test()
     {
-        $someService = $this->getContainer()->get(SomeService::class);
+        $someService = $this->someService;
     }
 }

 class SomeService
 {
 }

SimplifyForeachInstanceOfRector

Simplify unnecessary foreach check of instances

class: Rector\PHPUnit\Rector\Foreach_\SimplifyForeachInstanceOfRector

-foreach ($foos as $foo) {
-    $this->assertInstanceOf(SplFileInfo::class, $foo);
-}
+$this->assertContainsOnlyInstancesOf(\SplFileInfo::class, $foos);

SpecificAssertContainsRector

Change assertContains()/assertNotContains() method to new string and iterable alternatives

class: Rector\PHPUnit\Rector\MethodCall\SpecificAssertContainsRector

 final class SomeTest extends \PHPUnit\Framework\TestCase
 {
     public function test()
     {
-        $this->assertContains('foo', 'foo bar');
-        $this->assertNotContains('foo', 'foo bar');
+        $this->assertStringContainsString('foo', 'foo bar');
+        $this->assertStringNotContainsString('foo', 'foo bar');
     }
 }

SpecificAssertContainsWithoutIdentityRector

Change assertContains()/assertNotContains() with non-strict comparison to new specific alternatives

class: Rector\PHPUnit\Rector\MethodCall\SpecificAssertContainsWithoutIdentityRector

-final class SomeTest extends \PHPUnit\Framework\TestCase
+final class SomeTest extends TestCase
 {
     public function test()
     {
         $objects = [ new \stdClass(), new \stdClass(), new \stdClass() ];
-        $this->assertContains(new \stdClass(), $objects, 'message', false, false);
-        $this->assertNotContains(new \stdClass(), $objects, 'message', false, false);
+        $this->assertContainsEquals(new \stdClass(), $objects, 'message');
+        $this->assertNotContainsEquals(new \stdClass(), $objects, 'message');
     }
 }

SpecificAssertInternalTypeRector

Change assertInternalType()/assertNotInternalType() method to new specific alternatives

class: Rector\PHPUnit\Rector\MethodCall\SpecificAssertInternalTypeRector

 final class SomeTest extends \PHPUnit\Framework\TestCase
 {
     public function test()
     {
         $value = 'value';
-        $this->assertInternalType('string', $value);
-        $this->assertNotInternalType('array', $value);
+        $this->assertIsString($value);
+        $this->assertIsNotArray($value);
     }
 }

TestListenerToHooksRector

Refactor "*TestListener.php" to particular "*Hook.php" files

class: Rector\PHPUnit\Rector\Class_\TestListenerToHooksRector

 namespace App\Tests;

-use PHPUnit\Framework\TestListener;
-
-final class BeforeListHook implements TestListener
+final class BeforeListHook implements \PHPUnit\Runner\BeforeTestHook, \PHPUnit\Runner\AfterTestHook
 {
-    public function addError(Test $test, \Throwable $t, float $time): void
+    public function executeBeforeTest(Test $test): void
     {
-    }
-
-    public function addWarning(Test $test, Warning $e, float $time): void
-    {
-    }
-
-    public function addFailure(Test $test, AssertionFailedError $e, float $time): void
-    {
-    }
-
-    public function addIncompleteTest(Test $test, \Throwable $t, float $time): void
-    {
-    }
-
-    public function addRiskyTest(Test $test, \Throwable $t, float $time): void
-    {
-    }
-
-    public function addSkippedTest(Test $test, \Throwable $t, float $time): void
-    {
-    }
-
-    public function startTestSuite(TestSuite $suite): void
-    {
-    }
-
-    public function endTestSuite(TestSuite $suite): void
-    {
-    }
-
-    public function startTest(Test $test): void
-    {
         echo 'start test!';
     }

-    public function endTest(Test $test, float $time): void
+    public function executeAfterTest(Test $test, float $time): void
     {
         echo $time;
     }
 }

TryCatchToExpectExceptionRector

Turns try/catch to expectException() call

class: Rector\PHPUnit\Rector\ClassMethod\TryCatchToExpectExceptionRector

-try {
-    $someService->run();
-} catch (Throwable $exception) {
-    $this->assertInstanceOf(RuntimeException::class, $e);
-    $this->assertContains('There was an error executing the following script', $e->getMessage());
-}
+$this->expectException(RuntimeException::class);
+$this->expectExceptionMessage('There was an error executing the following script');
+$someService->run();

UseSpecificWillMethodRector

Changes ->will($this->xxx()) to one specific method

class: Rector\PHPUnit\Rector\MethodCall\UseSpecificWillMethodRector

 class SomeClass extends PHPUnit\Framework\TestCase
 {
     public function test()
     {
         $translator = $this->getMockBuilder('Symfony\Component\Translation\TranslatorInterface')->getMock();
         $translator->expects($this->any())
             ->method('trans')
-            ->with($this->equalTo('old max {{ max }}!'))
-            ->will($this->returnValue('translated max {{ max }}!'));
+            ->with('old max {{ max }}!')
+            ->willReturnValue('translated max {{ max }}!');
     }
 }

WithConsecutiveArgToArrayRector

Split withConsecutive() arg to array

class: Rector\PHPUnit\Rector\MethodCall\WithConsecutiveArgToArrayRector

 class SomeClass
 {
     public function run($one, $two)
     {
     }
 }

 class SomeTestCase extends \PHPUnit\Framework\TestCase
 {
     public function test()
     {
         $someClassMock = $this->createMock(SomeClass::class);
         $someClassMock
             ->expects($this->exactly(2))
             ->method('run')
-            ->withConsecutive(1, 2, 3, 5);
+            ->withConsecutive([1, 2], [3, 5]);
     }
 }

PHPUnitSymfony

AddMessageToEqualsResponseCodeRector

Add response content to response code assert, so it is easier to debug

class: Rector\PHPUnitSymfony\Rector\StaticCall\AddMessageToEqualsResponseCodeRector

 use PHPUnit\Framework\TestCase;
 use Symfony\Component\HttpFoundation\Response;

 final class SomeClassTest extends TestCase
 {
     public function test(Response $response)
     {
         $this->assertEquals(
             Response::HTTP_NO_CONTENT,
             $response->getStatusCode()
+            $response->getContent()
         );
     }
 }

PSR4

MultipleClassFileToPsr4ClassesRector

Change multiple classes in one file to standalone PSR-4 classes.

class: Rector\PSR4\Rector\Namespace_\MultipleClassFileToPsr4ClassesRector

+// new file: "app/Exceptions/FirstException.php"
 namespace App\Exceptions;

 use Exception;

 final class FirstException extends Exception
 {
 }
+
+// new file: "app/Exceptions/SecondException.php"
+namespace App\Exceptions;
+
+use Exception;

 final class SecondException extends Exception
 {
 }

NormalizeNamespaceByPSR4ComposerAutoloadRector

Adds namespace to namespace-less files or correct namespace to match PSR-4 in composer.json autoload section. Run with combination with "Rector\PSR4\Rector\Namespace_\MultipleClassFileToPsr4ClassesRector"

class: Rector\PSR4\Rector\FileWithoutNamespace\NormalizeNamespaceByPSR4ComposerAutoloadRector
with composer.json:

{
    "autoload": {
        "psr-4": {
            "App\\CustomNamespace\\": "src"
        }
    }
}

↓

 // src/SomeClass.php

+namespace App\CustomNamespace;
+
 class SomeClass
 {
 }

Performance

CountArrayToEmptyArrayComparisonRector

Change count array comparison to empty array comparison to improve performance

class: Rector\Performance\Rector\FuncCall\CountArrayToEmptyArrayComparisonRector

-count($array) === 0;
-count($array) > 0;
-! count($array);
+$array === [];
+$array !== [];
+$array === [];

PreslashSimpleFunctionRector

Add pre-slash to short named functions to improve performance

class: Rector\Performance\Rector\FuncCall\PreslashSimpleFunctionRector

 class SomeClass
 {
     public function shorten($value)
     {
-        return trim($value);
+        return \trim($value);
     }
 }

Php52

ContinueToBreakInSwitchRector

Use break instead of continue in switch statements

class: Rector\Php52\Rector\Switch_\ContinueToBreakInSwitchRector

 function some_run($value)
 {
     switch ($value) {
         case 1:
             echo 'Hi';
-            continue;
+            break;
         case 2:
             echo 'Hello';
             break;
     }
 }

VarToPublicPropertyRector

Remove unused private method

class: Rector\Php52\Rector\Property\VarToPublicPropertyRector

 final class SomeController
 {
-    var $name = 'Tom';
+    public $name = 'Tom';
 }

Php53

ClearReturnNewByReferenceRector

Remove reference from "$assign = &new Value;"

class: Rector\Php53\Rector\AssignRef\ClearReturnNewByReferenceRector

-$assign = &new Value;
+$assign = new Value;

DirNameFileConstantToDirConstantRector

Convert dirname(FILE) to DIR

class: Rector\Php53\Rector\FuncCall\DirNameFileConstantToDirConstantRector

 class SomeClass
 {
     public function run()
     {
-        return dirname(__FILE__);
+        return __DIR__;
     }
 }

ReplaceHttpServerVarsByServerRector

Rename old $HTTP_* variable names to new replacements

class: Rector\Php53\Rector\Variable\ReplaceHttpServerVarsByServerRector

-$serverVars = $HTTP_SERVER_VARS;
+$serverVars = $_SERVER;

TernaryToElvisRector

Use ?: instead of ?, where useful

class: Rector\Php53\Rector\Ternary\TernaryToElvisRector

 function elvis()
 {
-    $value = $a ? $a : false;
+    $value = $a ?: false;
 }

Php54

RemoveReferenceFromCallRector

Remove & from function and method calls

class: Rector\Php54\Rector\FuncCall\RemoveReferenceFromCallRector

 final class SomeClass
 {
     public function run($one)
     {
-        return strlen(&$one);
+        return strlen($one);
     }
 }

RemoveZeroBreakContinueRector

Remove 0 from break and continue

class: Rector\Php54\Rector\Break_\RemoveZeroBreakContinueRector

 class SomeClass
 {
     public function run($random)
     {
-        continue 0;
-        break 0;
+        continue;
+        break;

         $five = 5;
-        continue $five;
+        continue 5;

-        break $random;
+        break;
     }
 }

Php55

PregReplaceEModifierRector

The /e modifier is no longer supported, use preg_replace_callback instead

class: Rector\Php55\Rector\FuncCall\PregReplaceEModifierRector

 class SomeClass
 {
     public function run()
     {
-        $comment = preg_replace('~\b(\w)(\w+)~e', '"$1".strtolower("$2")', $comment);
+        $comment = preg_replace_callback('~\b(\w)(\w+)~', function ($matches) {
+              return($matches[1].strtolower($matches[2]));
+        }, , $comment);
     }
 }

StringClassNameToClassConstantRector

Replace string class names by ::class constant

🔧 configure it!

class: Rector\Php55\Rector\String_\StringClassNameToClassConstantRector

use Rector\Php55\Rector\String_\StringClassNameToClassConstantRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(StringClassNameToClassConstantRector::class)
        ->call('configure', [[
            StringClassNameToClassConstantRector::CLASSES_TO_SKIP => ['ClassName', 'AnotherClassName'],
        ]]);
};

↓

 class AnotherClass
 {
 }

 class SomeClass
 {
     public function run()
     {
-        return 'AnotherClass';
+        return \AnotherClass::class;
     }
 }

Php56

AddDefaultValueForUndefinedVariableRector

Adds default value for undefined variable

class: Rector\Php56\Rector\FunctionLike\AddDefaultValueForUndefinedVariableRector

 class SomeClass
 {
     public function run()
     {
+        $a = null;
         if (rand(0, 1)) {
             $a = 5;
         }
         echo $a;
     }
 }

PowToExpRector

Changes pow(val, val2) to ** (exp) parameter

class: Rector\Php56\Rector\FuncCall\PowToExpRector

-pow(1, 2);
+1**2;

Php70

BreakNotInLoopOrSwitchToReturnRector

Convert break outside for/foreach/switch context to return

class: Rector\Php70\Rector\Break_\BreakNotInLoopOrSwitchToReturnRector

 class SomeClass
 {
     public function run()
     {
         if ($isphp5)
             return 1;
         else
             return 2;
-        break;
+        return;
     }
 }

CallUserMethodRector

Changes call_user_method()/call_user_method_array() to call_user_func()/call_user_func_array()

class: Rector\Php70\Rector\FuncCall\CallUserMethodRector

-call_user_method($method, $obj, "arg1", "arg2");
+call_user_func(array(&$obj, "method"), "arg1", "arg2");

EmptyListRector

list() cannot be empty

class: Rector\Php70\Rector\List_\EmptyListRector

-'list() = $values;'
+'list($unusedGenerated) = $values;'

EregToPregMatchRector

Changes ereg*() to preg*() calls

class: Rector\Php70\Rector\FuncCall\EregToPregMatchRector

-ereg("hi")
+preg_match("#hi#");

ExceptionHandlerTypehintRector

Changes property @var annotations from annotation to type.

class: Rector\Php70\Rector\FunctionLike\ExceptionHandlerTypehintRector

-function handler(Exception $exception) { ... }
+function handler(Throwable $exception) { ... }
 set_exception_handler('handler');

IfToSpaceshipRector

Changes if/else to spaceship <=> where useful

class: Rector\Php70\Rector\If_\IfToSpaceshipRector

 class SomeClass
 {
     public function run()
     {
         usort($languages, function ($a, $b) {
-            if ($a[0] === $b[0]) {
-                return 0;
-            }
-
-            return ($a[0] < $b[0]) ? 1 : -1;
+            return $b[0] <=> $a[0];
         });
     }
 }

ListSplitStringRector

list() cannot split string directly anymore, use str_split()

class: Rector\Php70\Rector\Assign\ListSplitStringRector

-list($foo) = "string";
+list($foo) = str_split("string");

ListSwapArrayOrderRector

list() assigns variables in reverse order - relevant in array assign

class: Rector\Php70\Rector\Assign\ListSwapArrayOrderRector

-list($a[], $a[]) = [1, 2];
+list($a[], $a[]) = array_reverse([1, 2]);

MultiDirnameRector

Changes multiple dirname() calls to one with nesting level

class: Rector\Php70\Rector\FuncCall\MultiDirnameRector

-dirname(dirname($path));
+dirname($path, 2);

NonVariableToVariableOnFunctionCallRector

Transform non variable like arguments to variable where a function or method expects an argument passed by reference

class: Rector\Php70\Rector\FuncCall\NonVariableToVariableOnFunctionCallRector

-reset(a());
+$a = a(); reset($a);

Php4ConstructorRector

Changes PHP 4 style constructor to __construct.

class: Rector\Php70\Rector\ClassMethod\Php4ConstructorRector

 class SomeClass
 {
-    public function SomeClass()
+    public function __construct()
     {
     }
 }

RandomFunctionRector

Changes rand, srand and getrandmax by new mt_* alternatives.

class: Rector\Php70\Rector\FuncCall\RandomFunctionRector

-rand();
+mt_rand();

ReduceMultipleDefaultSwitchRector

Remove first default switch, that is ignored

class: Rector\Php70\Rector\Switch_\ReduceMultipleDefaultSwitchRector

 switch ($expr) {
     default:
-         echo "Hello World";
-
-    default:
          echo "Goodbye Moon!";
          break;
 }

RenameMktimeWithoutArgsToTimeRector

Renames mktime() without arguments to time()

class: Rector\Php70\Rector\FuncCall\RenameMktimeWithoutArgsToTimeRector

 class SomeClass
 {
     public function run()
     {
         $time = mktime(1, 2, 3);
-        $nextTime = mktime();
+        $nextTime = time();
     }
 }

StaticCallOnNonStaticToInstanceCallRector

Changes static call to instance call, where not useful

class: Rector\Php70\Rector\StaticCall\StaticCallOnNonStaticToInstanceCallRector

 class Something
 {
     public function doWork()
     {
     }
 }

 class Another
 {
     public function run()
     {
-        return Something::doWork();
+        return (new Something)->doWork();
     }
 }

TernaryToNullCoalescingRector

Changes unneeded null check to ?? operator

class: Rector\Php70\Rector\Ternary\TernaryToNullCoalescingRector

-$value === null ? 10 : $value;
+$value ?? 10;

-isset($value) ? $value : 10;
+$value ?? 10;

TernaryToSpaceshipRector

Use <=> spaceship instead of ternary with same effect

class: Rector\Php70\Rector\Ternary\TernaryToSpaceshipRector

 function order_func($a, $b) {
-    return ($a < $b) ? -1 : (($a > $b) ? 1 : 0);
+    return $a <=> $b;
 }

ThisCallOnStaticMethodToStaticCallRector

Changes $this->call() to static method to static call

class: Rector\Php70\Rector\MethodCall\ThisCallOnStaticMethodToStaticCallRector

 class SomeClass
 {
     public static function run()
     {
-        $this->eat();
+        static::eat();
     }

     public static function eat()
     {
     }
 }

WrapVariableVariableNameInCurlyBracesRector

Ensure variable variables are wrapped in curly braces

class: Rector\Php70\Rector\Variable\WrapVariableVariableNameInCurlyBracesRector

 function run($foo)
 {
-    global $$foo->bar;
+    global ${$foo->bar};
 }

Php71

AssignArrayToStringRector

String cannot be turned into array by assignment anymore

class: Rector\Php71\Rector\Assign\AssignArrayToStringRector

-$string = '';
+$string = [];
 $string[] = 1;

BinaryOpBetweenNumberAndStringRector

Change binary operation between some number + string to PHP 7.1 compatible version

class: Rector\Php71\Rector\BinaryOp\BinaryOpBetweenNumberAndStringRector

 class SomeClass
 {
     public function run()
     {
-        $value = 5 + '';
-        $value = 5.0 + 'hi';
+        $value = 5 + 0;
+        $value = 5.0 + 0
     }
 }

CountOnNullRector

Changes count() on null to safe ternary check

class: Rector\Php71\Rector\FuncCall\CountOnNullRector

 $values = null;
-$count = count($values);
+$count = count((array) $values);

IsIterableRector

Changes is_array + Traversable check to is_iterable

class: Rector\Php71\Rector\BinaryOp\IsIterableRector

-is_array($foo) || $foo instanceof Traversable;
+is_iterable($foo);

ListToArrayDestructRector

Remove & from new &X

class: Rector\Php71\Rector\List_\ListToArrayDestructRector

 class SomeClass
 {
     public function run()
     {
-        list($id1, $name1) = $data;
+        [$id1, $name1] = $data;

-        foreach ($data as list($id, $name)) {
+        foreach ($data as [$id, $name]) {
         }
     }
 }

MultiExceptionCatchRector

Changes multi catch of same exception to single one | separated.

class: Rector\Php71\Rector\TryCatch\MultiExceptionCatchRector

 try {
-    // Some code...
-} catch (ExceptionType1 $exception) {
-    $sameCode;
-} catch (ExceptionType2 $exception) {
-    $sameCode;
+   // Some code...
+} catch (ExceptionType1 | ExceptionType2 $exception) {
+   $sameCode;
 }

PublicConstantVisibilityRector

Add explicit public constant visibility.

class: Rector\Php71\Rector\ClassConst\PublicConstantVisibilityRector

 class SomeClass
 {
-    const HEY = 'you';
+    public const HEY = 'you';
 }

RemoveExtraParametersRector

Remove extra parameters

class: Rector\Php71\Rector\FuncCall\RemoveExtraParametersRector

-strlen("asdf", 1);
+strlen("asdf");

ReservedObjectRector

Changes reserved "Object" name to "Object" where can be configured

🔧 configure it!

class: Rector\Php71\Rector\Name\ReservedObjectRector

use Rector\Php71\Rector\Name\ReservedObjectRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ReservedObjectRector::class)
        ->call('configure', [[
            ReservedObjectRector::RESERVED_KEYWORDS_TO_REPLACEMENTS => [
                'ReservedObject' => 'SmartObject',
                'Object' => 'AnotherSmartObject',
            ],
        ]]);
};

↓

-class Object
+class SmartObject
 {
 }

Php72

CreateFunctionToAnonymousFunctionRector

Use anonymous functions instead of deprecated create_function()

class: Rector\Php72\Rector\FuncCall\CreateFunctionToAnonymousFunctionRector

 class ClassWithCreateFunction
 {
     public function run()
     {
-        $callable = create_function('$matches', "return '$delimiter' . strtolower(\$matches[1]);");
+        $callable = function($matches) use ($delimiter) {
+            return $delimiter . strtolower($matches[1]);
+        };
     }
 }

GetClassOnNullRector

Null is no more allowed in get_class()

class: Rector\Php72\Rector\FuncCall\GetClassOnNullRector

 final class SomeClass
 {
     public function getItem()
     {
         $value = null;
-        return get_class($value);
+        return $value !== null ? get_class($value) : self::class;
     }
 }

IsObjectOnIncompleteClassRector

Incomplete class returns inverted bool on is_object()

class: Rector\Php72\Rector\FuncCall\IsObjectOnIncompleteClassRector

 $incompleteObject = new __PHP_Incomplete_Class;
-$isObject = is_object($incompleteObject);
+$isObject = ! is_object($incompleteObject);

ListEachRector

each() function is deprecated, use key() and current() instead

class: Rector\Php72\Rector\Assign\ListEachRector

-list($key, $callback) = each($callbacks);
+$key = key($callbacks);
+$callback = current($callbacks);
+next($callbacks);

ParseStrWithResultArgumentRector

Use $result argument in parse_str() function

class: Rector\Php72\Rector\FuncCall\ParseStrWithResultArgumentRector

-parse_str($this->query);
-$data = get_defined_vars();
+parse_str($this->query, $result);
+$data = $result;

ReplaceEachAssignmentWithKeyCurrentRector

Replace each() assign outside loop

class: Rector\Php72\Rector\Assign\ReplaceEachAssignmentWithKeyCurrentRector

 $array = ['b' => 1, 'a' => 2];
-$eachedArray = each($array);
+$eachedArray[1] = current($array);
+$eachedArray['value'] = current($array);
+$eachedArray[0] = key($array);
+$eachedArray['key'] = key($array);
+next($array);

StringifyDefineRector

Make first argument of define() string

class: Rector\Php72\Rector\FuncCall\StringifyDefineRector

 class SomeClass
 {
     public function run(int $a)
     {
-         define(CONSTANT_2, 'value');
+         define('CONSTANT_2', 'value');
          define('CONSTANT', 'value');
     }
 }

StringsAssertNakedRector

String asserts must be passed directly to assert()

class: Rector\Php72\Rector\FuncCall\StringsAssertNakedRector

 function nakedAssert()
 {
-    assert('true === true');
-    assert("true === true");
+    assert(true === true);
+    assert(true === true);
 }

UnsetCastRector

Removes (unset) cast

class: Rector\Php72\Rector\Unset_\UnsetCastRector

-$different = (unset) $value;
+$different = null;

-$value = (unset) $value;
+unset($value);

WhileEachToForeachRector

each() function is deprecated, use foreach() instead.

class: Rector\Php72\Rector\While_\WhileEachToForeachRector

-while (list($key, $callback) = each($callbacks)) {
+foreach ($callbacks as $key => $callback) {
     // ...
 }

-while (list($key) = each($callbacks)) {
+foreach (array_keys($callbacks) as $key) {
     // ...
 }

Php73

ArrayKeyFirstLastRector

Make use of array_key_first() and array_key_last()

class: Rector\Php73\Rector\FuncCall\ArrayKeyFirstLastRector

-reset($items);
-$firstKey = key($items);
+$firstKey = array_key_first($items);

-end($items);
-$lastKey = key($items);
+$lastKey = array_key_last($items);

IsCountableRector

Changes is_array + Countable check to is_countable

class: Rector\Php73\Rector\BinaryOp\IsCountableRector

-is_array($foo) || $foo instanceof Countable;
+is_countable($foo);

JsonThrowOnErrorRector

Adds JSON_THROW_ON_ERROR to json_encode() and json_decode() to throw JsonException on error

class: Rector\Php73\Rector\FuncCall\JsonThrowOnErrorRector

-json_encode($content);
-json_decode($json);
+json_encode($content, JSON_THROW_ON_ERROR);
+json_decode($json, null, null, JSON_THROW_ON_ERROR);

RegexDashEscapeRector

Escape - in some cases

class: Rector\Php73\Rector\FuncCall\RegexDashEscapeRector

-preg_match("#[\w-()]#", 'some text');
+preg_match("#[\w\-()]#", 'some text');

RemoveMissingCompactVariableRector

Remove non-existing vars from compact()

class: Rector\Php73\Rector\FuncCall\RemoveMissingCompactVariableRector

 class SomeClass
 {
     public function run()
     {
         $value = 'yes';

-        compact('value', 'non_existing');
+        compact('value');
     }
 }

SensitiveConstantNameRector

Changes case insensitive constants to sensitive ones.

class: Rector\Php73\Rector\ConstFetch\SensitiveConstantNameRector

 define('FOO', 42, true);
 var_dump(FOO);
-var_dump(foo);
+var_dump(FOO);

SensitiveDefineRector

Changes case insensitive constants to sensitive ones.

class: Rector\Php73\Rector\FuncCall\SensitiveDefineRector

-define('FOO', 42, true);
+define('FOO', 42);

SensitiveHereNowDocRector

Changes heredoc/nowdoc that contains closing word to safe wrapper name

class: Rector\Php73\Rector\String_\SensitiveHereNowDocRector

-$value = <<<A
+$value = <<<A_WRAP
     A
-A
+A_WRAP

SetCookieRector

Convert setcookie argument to PHP7.3 option array

class: Rector\Php73\Rector\FuncCall\SetCookieRector

-setcookie('name', $value, 360);
+setcookie('name', $value, ['expires' => 360]);

-setcookie('name', $name, 0, '', '', true, true);
+setcookie('name', $name, ['expires' => 0, 'path' => '', 'domain' => '', 'secure' => true, 'httponly' => true]);

StringifyStrNeedlesRector

Makes needles explicit strings

class: Rector\Php73\Rector\FuncCall\StringifyStrNeedlesRector

 $needle = 5;
-$fivePosition = strpos('725', $needle);
+$fivePosition = strpos('725', (string) $needle);

Php74

AddLiteralSeparatorToNumberRector

Add "_" as thousands separator in numbers for higher or equals to limitValue config

🔧 configure it!

class: Rector\Php74\Rector\LNumber\AddLiteralSeparatorToNumberRector

use Rector\Php74\Rector\LNumber\AddLiteralSeparatorToNumberRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(AddLiteralSeparatorToNumberRector::class)
        ->call('configure', [[
            AddLiteralSeparatorToNumberRector::LIMIT_VALUE => 1000000,
        ]]);
};

↓

 class SomeClass
 {
     public function run()
     {
-        $int = 500000;
-        $float = 1000500.001;
+        $int = 500_000;
+        $float = 1_000_500.001;
     }
 }

ArrayKeyExistsOnPropertyRector

Change array_key_exists() on property to property_exists()

class: Rector\Php74\Rector\FuncCall\ArrayKeyExistsOnPropertyRector

 class SomeClass
 {
      public $value;
 }
 $someClass = new SomeClass;

-array_key_exists('value', $someClass);
+property_exists($someClass, 'value');

ArraySpreadInsteadOfArrayMergeRector

Change array_merge() to spread operator, except values with possible string key values

class: Rector\Php74\Rector\FuncCall\ArraySpreadInsteadOfArrayMergeRector

 class SomeClass
 {
     public function run($iter1, $iter2)
     {
-        $values = array_merge(iterator_to_array($iter1), iterator_to_array($iter2));
+        $values = [...$iter1, ...$iter2];

         // Or to generalize to all iterables
-        $anotherValues = array_merge(
-            is_array($iter1) ? $iter1 : iterator_to_array($iter1),
-            is_array($iter2) ? $iter2 : iterator_to_array($iter2)
-        );
+        $anotherValues = [...$iter1, ...$iter2];
     }
 }

ChangeReflectionTypeToStringToGetNameRector

Change string calls on ReflectionType

class: Rector\Php74\Rector\MethodCall\ChangeReflectionTypeToStringToGetNameRector

 class SomeClass
 {
     public function go(ReflectionFunction $reflectionFunction)
     {
         $parameterReflection = $reflectionFunction->getParameters()[0];

-        $paramType = (string) $parameterReflection->getType();
+        $paramType = (string) ($parameterReflection->getType() ? $parameterReflection->getType()->getName() : null);

-        $stringValue = 'hey' . $reflectionFunction->getReturnType();
+        $stringValue = 'hey' . ($reflectionFunction->getReturnType() ? $reflectionFunction->getReturnType()->getName() : null);

         // keep
         return $reflectionFunction->getReturnType();
     }
 }

ClassConstantToSelfClassRector

Change __CLASS__ to self::class

class: Rector\Php74\Rector\Class_\ClassConstantToSelfClassRector

 class SomeClass
 {
    public function callOnMe()
    {
-       var_dump(__CLASS__);
+       var_dump(self::class);
    }
 }

ClosureToArrowFunctionRector

Change closure to arrow function

class: Rector\Php74\Rector\Closure\ClosureToArrowFunctionRector

 class SomeClass
 {
     public function run($meetups)
     {
-        return array_filter($meetups, function (Meetup $meetup) {
-            return is_object($meetup);
-        });
+        return array_filter($meetups, fn(Meetup $meetup) => is_object($meetup));
     }
 }

ExportToReflectionFunctionRector

Change export() to ReflectionFunction alternatives

class: Rector\Php74\Rector\StaticCall\ExportToReflectionFunctionRector

-$reflectionFunction = ReflectionFunction::export('foo');
-$reflectionFunctionAsString = ReflectionFunction::export('foo', true);
+$reflectionFunction = new ReflectionFunction('foo');
+$reflectionFunctionAsString = (string) new ReflectionFunction('foo');

FilterVarToAddSlashesRector

Change filter_var() with slash escaping to addslashes()

class: Rector\Php74\Rector\FuncCall\FilterVarToAddSlashesRector

 $var= "Satya's here!";
-filter_var($var, FILTER_SANITIZE_MAGIC_QUOTES);
+addslashes($var);

GetCalledClassToStaticClassRector

Change get_called_class() to static::class

class: Rector\Php74\Rector\FuncCall\GetCalledClassToStaticClassRector

 class SomeClass
 {
    public function callOnMe()
    {
-       var_dump(get_called_class());
+       var_dump(static::class);
    }
 }

MbStrrposEncodingArgumentPositionRector

Change mb_strrpos() encoding argument position

class: Rector\Php74\Rector\FuncCall\MbStrrposEncodingArgumentPositionRector

-mb_strrpos($text, "abc", "UTF-8");
+mb_strrpos($text, "abc", 0, "UTF-8");

NullCoalescingOperatorRector

Use null coalescing operator ??=

class: Rector\Php74\Rector\Assign\NullCoalescingOperatorRector

 $array = [];
-$array['user_id'] = $array['user_id'] ?? 'value';
+$array['user_id'] ??= 'value';

RealToFloatTypeCastRector

Change deprecated (real) to (float)

class: Rector\Php74\Rector\Double\RealToFloatTypeCastRector

 class SomeClass
 {
     public function run()
     {
-        $number = (real) 5;
+        $number = (float) 5;
         $number = (float) 5;
         $number = (double) 5;
     }
 }

ReservedFnFunctionRector

Change fn() function name, since it will be reserved keyword

🔧 configure it!

class: Rector\Php74\Rector\Function_\ReservedFnFunctionRector

use Rector\Php74\Rector\Function_\ReservedFnFunctionRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(ReservedFnFunctionRector::class)
        ->call('configure', [[
            ReservedFnFunctionRector::RESERVED_NAMES_TO_NEW_ONES => [
                'fn' => 'someFunctionName',
            ],
        ]]);
};

↓

 class SomeClass
 {
     public function run()
     {
-        function fn($value)
+        function f($value)
         {
             return $value;
         }

-        fn(5);
+        f(5);
     }
 }

RestoreDefaultNullToNullableTypePropertyRector

Add null default to properties with PHP 7.4 property nullable type

class: Rector\Php74\Rector\Property\RestoreDefaultNullToNullableTypePropertyRector

 class SomeClass
 {
-    public ?string $name;
+    public ?string $name = null;
 }

TypedPropertyFromStrictConstructorRector

Add typed properties based only on strict constructor types

class: Rector\Php74\Rector\Property\TypedPropertyFromStrictConstructorRector

 class SomeObject
 {
-    private $name;
+    private string $name;

     public function __construct(string $name)
     {
         $this->name = $name;
     }
 }

TypedPropertyRector

Changes property @var annotations from annotation to type.

🔧 configure it!

class: Rector\Php74\Rector\Property\TypedPropertyRector

use Rector\Php74\Rector\Property\TypedPropertyRector;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $services = $containerConfigurator->services();

    $services->set(TypedPropertyRector::class)
        ->call('configure', [[
            TypedPropertyRector::CLASS_LIKE_TYPE_ONLY => false,
        ]]);
};

↓

 final class SomeClass
 {
-    /**
-     * @var int
-     */
-    private count;
+    private int count;
 }

Php80

AnnotationToAttributeRector

Change annotation to attribute

class: Rector\Php80\Rector\Class_\AnnotationToAttributeRector

 use Doctrine\ORM\Attributes as ORM;

-/**
-  * @ORM\Entity
-  */
+#[ORM\Entity]
 class SomeClass
 {
 }

ChangeSwitchToMatchRector

Change switch() to match()

class: Rector\Php80\Rector\Switch_\ChangeSwitchToMatchRector

 class SomeClass
 {
     public function run()
     {
-        switch ($this->lexer->lookahead['type']) {
-            case Lexer::T_SELECT:
-                $statement = $this->SelectStatement();
-                break;
-
-            case Lexer::T_UPDATE:
-                $statement = $this->UpdateStatement();
-                break;
-
-            default:
-                $statement = $this->syntaxError('SELECT, UPDATE or DELETE');
-                break;
-        }
+        $statement = match ($this->lexer->lookahead['type']) {
+            Lexer::T_SELECT => $this->SelectStatement(),
+            Lexer::T_UPDATE => $this->UpdateStatement(),
+            default => $this->syntaxError('SELECT, UPDATE or DELETE'),
+        };
     }
 }

ClassOnObjectRector

Change get_class($object) to faster $object::class

class: Rector\Php80\Rector\FuncCall\ClassOnObjectRector

 class SomeClass
 {
     public function run($object)
     {
-        return get_class($object);
+        return $object::class;
     }
 }

ClassPropertyAssignToConstructorPromotionRector

Change simple property init and assign to constructor promotion

class: Rector\Php80\Rector\Class_\ClassPropertyAssignToConstructorPromotionRector

 class SomeClass
 {
-    public float $someVariable;
-
-    public function __construct(float $someVariable = 0.0)
+    public function __construct(private float $someVariable = 0.0)
     {
-        $this->someVariable = $someVariable;
     }
 }

FinalPrivateToPrivateVisibilityRector

Changes method visibility from final private to only private

class: Rector\Php80\Rector\ClassMethod\FinalPrivateToPrivateVisibilityRector

 class SomeClass
 {
-    final private function getter() {
+    private function getter() {
         return $this;
     }
 }

GetDebugTypeRector

Change ternary type resolve to get_debug_type()

class: Rector\Php80\Rector\Ternary\GetDebugTypeRector

 class SomeClass
 {
     public function run($value)
     {
-        return is_object($value) ? get_class($value) : gettype($value);
+        return get_debug_type($value);
     }
 }

NullsafeOperatorRector

Change if null check with nullsafe operator ?-> with full short circuiting

class: Rector\Php80\Rector\If_\NullsafeOperatorRector

 class SomeClass
 {
     public function run($someObject)
     {
-        $someObject2 = $someObject->mayFail1();
-        if ($someObject2 === null) {
-            return null;
-        }
-
-        return $someObject2->mayFail2();
+        return $someObject->mayFail1()?->mayFail2();
     }
 }

OptionalParametersAfterRequiredRector

Move required parameters after optional ones

class: Rector\Php80\Rector\ClassMethod\OptionalParametersAfterRequiredRector

 class SomeObject
 {
-    public function run($optional = 1, $required)
+    public function run($required, $optional = 1)
     {
     }
 }

RemoveUnusedVariableInCatchRector

Remove unused variable in catch()

class: Rector\Php80\Rector\Catch_\RemoveUnusedVariableInCatchRector

 final class SomeClass
 {
     public function run()
     {
         try {
-        } catch (Throwable $notUsedThrowable) {
+        } catch (Throwable) {
         }
     }
 }

SetStateToStaticRector

Adds static visibility to __set_state() methods

class: Rector\Php80\Rector\ClassMethod\SetStateToStaticRector

 class SomeClass
 {
-    public function __set_state($properties) {
+    public static function __set_state($properties) {

     }
 }

StrContainsRector

Replace strpos() !== false and strstr() with str_contains()

class: Rector\Php80\Rector\NotIdentical\StrContainsRector

 class SomeClass
 {
     public function run()
     {
-        return strpos('abc', 'a') !== false;
+        return str_contains('abc', 'a');
     }
 }

StrEndsWithRector

Change helper functions to str_ends_with()

class: Rector\Php80\Rector\Identical\StrEndsWithRector

 class SomeClass
 {
     public function run()
     {
-        $isMatch = substr($haystack, -strlen($needle)) === $needle;
+        $isMatch = str_ends_with($haystack, $needle);
     }
 }

StrStartsWithRector

Change helper functions to str_starts_with()

class: Rector\Php80\Rector\Identical\StrStartsWithRector

 class SomeClass
 {
     public function run()
     {
-        $isMatch = substr($haystack, 0, strlen($needle)) === $needle;
+        $isMatch = str_starts_with($haystack, $needle);

-        $isNotMatch = substr($haystack, 0, strlen($needle)) !== $needle;
+        $isNotMatch = ! str_starts_with($haystack, $needle);
     }
 }

StringableForToStringRector

Add Stringable interface to classes with __toString() method

class: Rector\Php80\Rector\Class_\StringableForToStringRector

-class SomeClass
+class SomeClass implements Stringable
 {
-    public function __toString()
+    public function __toString(): string
     {
         return 'I can stringz';
     }
 }

TokenGetAllToObjectRector

Complete missing constructor dependency instance by type

class: Rector\Php80\Rector\FuncCall\TokenGetAllToObjectRector

 final class SomeClass
 {
     public function run()
     {
-        $tokens = token_get_all($code);
-        foreach ($tokens as $token) {
-            if (is_array($token)) {
-               $name = token_name($token[0]);
-               $text = $token[1];
-            } else {
-               $name = null;
-               $text = $token;
-            }
+        $tokens = \PhpToken::getAll($code);
+        foreach ($tokens as $phpToken) {
+           $name = $phpToken->getTokenName();
+           $text = $phpToken->text;
         }
     }
 }

UnionTypesRector

Change docs types to union types, where possible (properties are covered by TypedPropertiesRector)

class: Rector\Php80\Rector\FunctionLike\UnionTypesRector

 class SomeClass
 {
-    /**
-     * @param array|int $number
-     * @return bool|float
-     */
-    public function go($number)
+    public function go(array|int $number): bool|float
     {
     }
 }