ergebnis/rector-rules

Provides rules for rector/rector.

1.14.0 2026-03-18 11:03 UTC

Requires

• php: ~7.4.0 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
• nikic/php-parser: ^4.17.1 || ^5.0.0
• phpstan/phpstan: ^2.0.0
• rector/rector: ^2.3.8

Requires (Dev)

• ergebnis/composer-normalize: ^2.50.0
• ergebnis/data-provider: ^3.6.0
• ergebnis/license: ^2.7.0
• ergebnis/php-cs-fixer-config: ^6.60.2
• ergebnis/phpunit-slow-test-detector: ^2.24.0
• phpstan/extension-installer: ^1.4.3
• phpstan/phpstan-deprecation-rules: ^2.0.4
• phpstan/phpstan-phpunit: ^2.0.16
• phpstan/phpstan-strict-rules: ^2.0.10
• phpunit/phpunit: ^9.6.33

MIT

• Andreas Möller

README

This project provides a composer package with rules for rector/rector.

Installation

Run

composer require --dev ergebnis/rector-rules

Rules

This project provides the following rules for rector/rector:

• Ergebnis\Rector\Rules\Arrays\SortAssociativeArrayByKeyRector
• Ergebnis\Rector\Rules\Faker\GeneratorPropertyFetchToMethodCallRector
• Ergebnis\Rector\Rules\Files\ReferenceNamespacedSymbolsRelativeToNamespacePrefixRector

Arrays

Arrays\SortAssociativeArrayByKeyRector

This rule sorts associative arrays by key.

 <?php

 $data = [
+    'bar' => [
+        'quux' => 'quuz',
+        'quz' => 'qux',
+    ],
     'foo' => [
         'foo',
         'bar',
         'baz',
     ],
-    'bar' => [
-        'quz' => 'qux',
-        'quux' => 'quuz',
-    ],
 ];

Configuration

• comparison_function: the comparison function, one of ('strcasecmp', 'strcmp', 'strnatcasecmp', or 'strnatcmp'), defaults to 'strcmp'
• direction: the sorting direction (one of 'asc', 'desc'), defaults to asc

Faker

Faker\GeneratorPropertyFetchToMethodCallRector

This rule replaces references to deprecated properties of Faker\Generator with method calls.

 <?php

 use Faker\Factory;

 $faker = Factory::create();

- $faker->boolean;
+ $faker->boolean();

Files

Files\ReferenceNamespacedSymbolsRelativeToNamespacePrefixRector

This rule replaces references to namespaced symbols (classes, functions, constants) whose fully-qualified name starts with a namespace prefix so they are relative to that prefix.

 <?php

 namespace App;

-use Foo\Bar;
-use Foo\Bar\Baz\Qux;
+use Foo\Bar\Baz;

-new Bar\Baz\Qux\Quuz();
-new Qux\Quuz\Grauply();
-new \Foo\Bar\Baz\Qux\Quuz();
+new Baz\Qux\Quuz();
+new Baz\Qux\Quuz\Grauply();
+new Baz\Qux\Quuz();

Configuration

• forceRelativeReferences: a boolean (default false) that forces references to be expressed relative to the namespace prefix even when the file namespace matches the prefix
• namespacePrefixes: a list of namespace prefixes to consolidate (e.g., ['Foo\Bar\Baz', 'Example\Domain'])
• parentNamespacePrefixes: a list of parent namespace prefixes for automatic discovery of namespace prefixes per file (e.g., ['Foo\Bar'] will discover Foo\Bar\Baz as a namespace prefix when a file references symbols under Foo\Bar\Baz)

Changelog

The maintainers of this project record notable changes to this project in a changelog.

Contributing

The maintainers of this project suggest following the contribution guide.

Code of Conduct

The maintainers of this project ask contributors to follow the code of conduct.

General Support Policy

The maintainers of this project provide limited support.

You can support the maintenance of this project by sponsoring @ergebnis.

PHP Version Support Policy

This project supports PHP versions with active and security support.

The maintainers of this project add support for a PHP version following its initial release and drop support for a PHP version when it has reached the end of security support.

Security Policy

This project has a security policy.

License

This project uses the MIT license.

Social

Follow @localheinz and @ergebnis on Twitter.