rector/rector 2.6.7

Released Rector 2.6.7

on PHP Packagist

Agentic Experience

This release improves Rector for automated, CI and non-interactive workflows: validate configuration without processing files, limit the amount of changes per run, select multiple rules at once, and get more useful machine-readable output.

• Bump PHPStan to ^2.2.14 and PHP-Parser to ^5.9, regenerate preload (#8491)

New validate-config command (#8450, #8452)

New validate-config command checks rector.php for configuration issues without processing any source files.

vendor/bin/rector validate-config

It reports deprecated rules and configuration, invalid skips, duplicated rule registrations and other config hygiene issues. A valid config exits with 0, while detected issues exit with 1, so the command can be used directly as a CI gate.

For machine-readable output:

vendor/bin/rector validate-config --output-format=json

{
    "valid": true,
    "issue_count": 0
}

Limit a run with --max-changes (#8449)

New --max-changes option lets automated runs process changes in smaller batches:

vendor/bin/rector process --dry-run --max-changes=50

The limit counts applied rule changes rather than files. The current file is always finished before Rector stops, so the final number may be slightly above the requested limit.

Run multiple rules with --only (#8451)

--only can now be repeated to run several selected rules in a single pass:

vendor/bin/rector process \
    --only=App\\Rector\\FooRector \
    --only=App\\Rector\\BarRector

A single --only continues to work as before.

Per-line rule attribution in JSON output (#8448)

JSON output now includes a changes list with the Rector rule and source line for every applied change:

{
    "changes": [
        {
            "rector": "Rector\\Php80\\Rector\\Identical\\StrStartsWithRector",
            "line": 38
        }
    ]
}

The existing applied_rectors field remains unchanged for backward compatibility.

Cleaner non-interactive output

Non-interactive runs are now quieter and safer:

• Disable progress bar when output is not a TTY (#8444)
• Never emit ANSI escape sequences to non-TTY output, even with --ansi (#8453)
• Do not prompt or automatically create rector.php when input is non-interactive (#8454)

Sets

• Add DirnameDirConcatStringToDirectStringPathRector to the code-quality set (#8470)
• Add NarrowBoolDocblockReturnTypeRector to the type-declaration-docblocks set (#8484)

Bugfixes 🐛

• CompleteDynamicPropertiesRector: skip when a not-autoloaded ancestor may already declare the property (#8441)
• TypeDeclarationDocblocks: restrict array docblock inference to safer/private cases and avoid narrowing properties with incompatible assignment shapes (#8435, #8436, #8437, #8442)
• DocblockVarArrayFromPropertyDefaultsRector: widen empty nested array defaults to mixed[] instead of never[] (#8439, #8474)
• DocblockReturnArrayFromDirectArrayInstanceRector: skip empty array returns instead of producing an overly narrow array{} docblock (#8434)
• IfToNullCoalescingAssignRector: preserve comments inside the converted if (#8443)
• RemoveDeadIfBlockRector: keep empty if with elseif and trailing else where rewriting would change behavior (#8446)
• RemoveParentDelegatingClassMethodRector: keep delegating methods carrying annotations such as @Route (#8459)
• StrContainsRector: skip empty string needles to avoid behavior changes (#8460)
• Parallel processing: guard processes that quit before their encoder is initialized, fixing crashes with high worker counts (#8461)
• RemoveDeadCatchRector: keep rethrowing catches before catch-all Throwable/Exception handlers (#8462)
• SimplifyUselessVariableRector: preserve variables referenced by commented-out code and stop folding compound assignments into returns (#8468)
• ReplaceArgumentDefaultValueRector: avoid re-applying already migrated imported class constants and correctly report applied changes (#8475)
• Terminated block detection: ignore trailing comments and recognize terminating infinite loops (#8476)
• ForeachToArrayAnyRector: do not drop elseif or else branches when converting a foreach (#8480)
• Set Option::SOURCE from the actually resolved paths in regular Rector runs (#8424)

Deprecations 💀

• --rules-summary - use --output-format=json, which provides applied rules together with files and lines (#8457)
• DynamicDocBlockPropertyToNativePropertyRector - could change a public-by-design @property into a private native property (#8470)
• FluentSettersToStandaloneCallMethodRector and RemoveReturnThisFromSetterClassMethodRector - fluent API semantics are too use-case dependent for a generic transformation (#8473)
• ListSwapArrayOrderRector - can turn valid list() assignments into broken code; removed from PHP 7.0 sets (#8477)
• Remove RenameDeprecatedMethodCallRector - inferring replacement methods from free-text @deprecated descriptions is too risky; explicit rename rules are more predictable (#8485)

rector-doctrine 🟠

• TypedPropertyFromToOneRelationTypeRector: skip untyped parent property overrides (#520)
• TypedPropertyFromColumnTypeRector: skip untyped parent property overrides (#521)
• TypedPropertyFromColumnTypeRector: fix numeric defaults for decimal/bigint columns (#522)
• TypedPropertyFromColumnTypeRector: make generated property type nullable when a null default is present (#523)

rector-phpunit 🟢

• Deprecate RemoveNamedArgsInDataProviderRector (#782)

rector-symfony 🎵

• Move EnableValidationAttributesRector into the composer-based upgrade path (#1065)
• ConsoleExecuteReturnIntRector: correctly report changes when rewriting an existing return (#1064)

rector-downgrade-php ⬇️

• DowngradeNeverTypeDeclarationRector: support never return types on arrow functions (#397)
• Add DowngradeReflectionMethodHasPrototypeRector for ReflectionMethod::hasPrototype() when downgrading below PHP 8.2 (#398)