Starting with Rector PHP: Improving Your PHP Code with Automation


Maintaining clean and efficient code is crucial for project success. Rector PHP emerges as a powerful tool, offering developers a seamless path to code transformation and enhancement.
Rector PHP is an open-source automation tool for PHP, and it simplifies the process of code upgrades, refactoring, and modernization, bringing significant benefits to developers and their projects.

Why Rector PHP Matters

Before to show how to install, how to configure and how to execute Rector PHP, let’s see why using Rector PHP is crucial in writing PHP Code.

Code Refactoring

Rector PHP automates tedious code refactoring tasks, allowing developers to focus on building new features and improving functionality. It transforms legacy code into modern, maintainable structures, enhancing readability and reducing technical debt.
Some examples are:

  • removing unused assigns to variables;
  • splitting if statement, when if condition always break execution flow;
  • adding return type void to function like without any return;
  • changing the return type based on strict scalar returns – string, int, float or bool
  • adding typed property from assigned types
  • … and more …

Refactoring your PHP code with Rector PHP

Standardization Across Projects

If you maintain multiple Open Source projects, consistency across them is crucial in software development.
Rector PHP ensures the uniform application of coding standards across projects, fostering a cohesive and easily understandable codebase. This standardization streamlines collaboration among developers and facilitates a smoother onboarding process for new team members.

The configuration of Rector and the list of rules you want to apply in your code are detailed in the rector.php configuration file. You can create a configuration file using the rector command, either starting from scratch or by copying it from another project. In my case, I have a rector.php file that I reuse across multiple projects.

Efficient Upgrades

Adapting to the latest PHP versions and adopting new language features can be time-consuming. Rector PHP streamlines this process by automatically handling the necessary code changes, making upgrades more efficient and reducing the risk of errors.

For example, if you want to ensure the utilization of new PHP 8.3 features, you can set the LevelSetList::UP_TO_PHP_83 in the configuration. Rector will then update your code to incorporate the new features provided by PHP 8.3. This includes actions such as adding types to constants, introducing the override attribute to overridden methods, and more.

Upgrading your Code using Rector PHP

Enhanced Code Quality

Rector PHP actively contributes to improved code quality by addressing common issues, enforcing best practices, and identifying potential weaknesses in the code. This results in a more robust and secure codebase, aligning with the ever-evolving standards of modern PHP development.

Improving the Code quality with Rector PHP

Time and Cost Savings

Automating repetitive tasks not only increases development speed but also reduces costs associated with manual code maintenance. Rector PHP allows developers to allocate their time more strategically, focusing on higher-value tasks that contribute to project success.

Adding Rector PHP to your project

For installing Rector PHP you can use the composer command.
Because Rector is a development package, you must use the `–dev’ option.

composer require rector/rector --dev

Once you have installed Rectory PHP you can execute it, launching the command locate in vendor/bin directory:


The first time you launch Rector PHP in your project, it is detected if the rector.php exists. Unluess you already created the rector.php file, and it doesn’t exist, the rector.php command will automatically create the rector.php configuration file.

Rector PHP creating a configuration file

Rector will auto-magically define a basic configuration based on the directory found in your project and the version of the PHP used in the composer.json file.
With the configuration file you can define the path (or paths) to analyze:

    __DIR__ . '/src',

With the configuration file you can also set one rule like:


Or setting a set of rules:


If you want to explore more the rules, you can take a look at this page:

As you can see, we have a lot of rules that we can choose.
So to make it easy to start using Rector, you can start from some sets. I usually use these sets:


In the configuration above, I’m using rules for fixing:

My whole basic rector.php file is:


use RectorConfigRectorConfig;
use RectorSetValueObjectLevelSetList;
use RectorSetValueObjectSetList;

return static function (RectorConfig $rectorConfig): void {
        __DIR__ . '/src',


In a daily usage, I would like to suggest to remove the UP_TO_PHP_82 ruleset, and use the UP_TO rule when you want to perform an upgrade of the Ruleset as explained here:

Now we’ve installed Rector PHP and setup a minimal configuration, we can execute Rector PHP.

Launching Rector PHP

Now, you can launch the rector command, locate in the vendor/bin directory:

vendor/bin/rector --dry-run

We are using the --dry-run option just to see the potential changes, according to the rules defined in the configuration file. If we want to apply the changes on the source code files, we can execute rector by omitting the --dry-run option:


The files will be changed according to the defined rules.

Applying Rector rules

If we want to obtain the execution report in JSON format we can use the --output-format=json option:

vendor/bin/rector --output-format=json --dry-run

You can combine the output-format option with the dry-run option.

If you’re using other quality management tools like a static code analyzer and a code style fixer, you’d probably want to orchestrate and manage the execution configuration in a centralized place like the scripts section in the composer file.

Setting the execution in the composer

If you want, you can create a script in the composer file.
This is useful for other people who want to be onboarded into the project and see which command are usually executed.
Here is an extracted section from the composer.json file:

"scripts": {
    "cs-fix": "pint",
    "rector-fix": "rector",
    "rector-preview": "rector --dry-run",
    "rector-ci": "rector --dry-run --no-progress-bar"
"scripts-descriptions": {
    "cs-fix": "Fixing the Code Style according to PER standards",
    "rector-fix": "Fixing the code according to the Rector Rules",
    "rector-preview": "Showing the suggested changes from Rector",
    "rector-ci": "Executing Rector in a CI workflow"

So now you can execute the composer run rector-fix command to launch rector.

Composer Run


In summary, Rector PHP stands as a game-changer in PHP development, automating tasks, improving code quality, and simplifying migrations. With its focus on efficiency and best practices, Rector PHP is an invaluable tool for developers seeking streamlined workflows and enhanced codebases. Experience the benefits of automated code transformation with Rector PHP:

See you on X or see you on Mastodon.

Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post–-the-simple-web-app-trio

DaisyUI + Alpine.js + – the simple web app trio

Next Post

How to use Elm extensible records

Related Posts