Rector Laravel

https://github.com/driftingly/rector-laravel
Admin
Rector Rules for Laravel automates Laravel upgrades and improves code quality by providing a set of...
Tokens:204,008
Snippets:1,221
Trust Score:8.7
License:MIT
Update:1 week ago
Show doc for...
Tokens:
Raw
### Configure StaticFacadeToServiceMethodCallRector with StaticCallToMethodCall

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules-map.md

Configures the StaticFacadeToServiceMethodCallRector to replace a static facade call with a method call on an injected service. The example maps Config::get() to the 'get' method on the Config repository.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\StaticCall\StaticFacadeToServiceMethodCallRector;
use RectorLaravel\ValueObject\StaticCallToMethodCall;

return RectorConfig::configure()
    ->withConfiguredRule(StaticFacadeToServiceMethodCallRector::class, [
        new StaticCallToMethodCall(
            'Illuminate\Support\Facades\Config',
            'get',
            'Illuminate\Contracts\Config\Repository',
            'get'
        ),
    ]);
```

--------------------------------

### Configure a rule with withConfiguredRule

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/configuration.md

Shows how to configure a rule with custom arguments, using RemoveDumpDataDeadCodeRector as an example.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\FuncCall\RemoveDumpDataDeadCodeRector;

return RectorConfig::configure()
    ->withConfiguredRule(RemoveDumpDataDeadCodeRector::class, [
        'dd', 'dump', 'var_dump'
    ]);
```

--------------------------------

### Install as dev dependency

Source: https://github.com/driftingly/rector-laravel/blob/main/README.md

Install the package as a dev dependency using Composer.

```bash
composer require --dev driftingly/rector-laravel
```

--------------------------------

### Configure ApplyDefaultInsteadOfNullCoalesceRector

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules-map.md

Configures the ApplyDefaultInsteadOfNullCoalesceRector to replace null coalescing with a default value. The example applies it to the 'config' function, targeting the Config repository type.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\Coalesce\ApplyDefaultInsteadOfNullCoalesceRector;
use RectorLaravel\ValueObject\ApplyDefaultInsteadOfNullCoalesce;

return RectorConfig::configure()
    ->withConfiguredRule(ApplyDefaultInsteadOfNullCoalesceRector::class, [
        new ApplyDefaultInsteadOfNullCoalesce('config', new \PHPStan\Type\ObjectType('Illuminate\Contracts\Config\Repository')),
    ]);
```

--------------------------------

### Configure EloquentMagicMethodToQueryBuilderRector with EXCLUDE_METHODS

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules-map.md

Configures the EloquentMagicMethodToQueryBuilderRector to exclude specific magic methods from conversion. The example excludes 'find' and 'firstOrFail'.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\StaticCall\EloquentMagicMethodToQueryBuilderRector;

return RectorConfig::configure()
    ->withConfiguredRule(EloquentMagicMethodToQueryBuilderRector::class, [
        EloquentMagicMethodToQueryBuilderRector::EXCLUDE_METHODS => ['find', 'firstOrFail'],
    ]);
```

--------------------------------

### Add mockConsoleOutput = false to console tests

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Adds `$this->mockConsoleOutput = false;` to console tests that work with output content. The diff shows adding a `setUp()` method with the property assignment.

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

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

--------------------------------

### Configure ArgumentFuncCallToMethodCallRector with ArrayFuncCallToMethodCall

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules-map.md

Configures the ArgumentFuncCallToMethodCallRector to convert a static-facade-like function call to a method call on an injected service. The example maps 'auth_login' to the 'login' method on the AuthManager, with 'isLoggedIn' as the check method.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\FuncCall\ArgumentFuncCallToMethodCallRector;
use RectorLaravel\ValueObject\ArrayFuncCallToMethodCall;

return RectorConfig::configure()
    ->withConfiguredRule(ArgumentFuncCallToMethodCallRector::class, [
        new ArrayFuncCallToMethodCall(
            'auth_login',
            'Illuminate\Auth\AuthManager',
            'login',
            'isLoggedIn'
        ),
    ]);
```

--------------------------------

### Automate Laravel upgrades with withComposerBased

Source: https://github.com/driftingly/rector-laravel/blob/main/README.md

Use withComposerBased(laravel: true) to automatically apply version sets based on installed Laravel version.

```php
<?php declare(strict_types=1);

use Rector\Config\RectorConfig;

return RectorConfig::configure()
    ->withComposerBased(laravel: true, /** other options */);
```

--------------------------------

### ReverseConditionableMethodCallRector: Reverse when/unless (first example)

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Reverse conditionable method calls. This diff shows converting `when(!$condition, ...)` to `unless($condition, ...)`.

```diff
-$conditionable->when(!$condition, function () {});
+$conditionable->unless($condition, function () {});
```

--------------------------------

### RedirectBackToBackHelperRector: Replace redirect()->back() and Redirect::back() with back()

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Replaces both redirect()->back() and Redirect::back() with the back() helper. The example shows two methods in a controller, each returning back()->with('error', 'Incorrect Details.'). Requires the use Illuminate\Support\Facades\Redirect; import when using the facade.

```diff
 use Illuminate\Support\Facades\Redirect;

 class MyController
 {
     public function store()
     {
-        return redirect()->back()->with('error', 'Incorrect Details.')
+        return back()->with('error', 'Incorrect Details.')
     }

     public function update()
     {
-        return Redirect::back()->with('error', 'Incorrect Details.')
+        return back()->with('error', 'Incorrect Details.')
     }
 }

```

--------------------------------

### ReverseConditionableMethodCallRector: Reverse when/unless (second example)

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Reverse conditionable method calls. This diff shows converting `unless(!$condition, ...)` to `when($condition, ...)`.

```diff
-$conditionable->unless(!$condition, function () {});
+$conditionable->when($condition, function () {});
```

--------------------------------

### CarbonToDateFacadeRector: Replace Carbon static calls with Date facade

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Refactor Carbon static method calls to use the Date facade instead. The first example shows replacing `Carbon::now()` and `Carbon::parse()` with `Date::now()` and `Date::parse()`. The second example shows replacing `Carbon::now()` and `Carbon::today()` with `Date::now()` and `Date::today()`, and also changes the import from `Illuminate\Support\Carbon` to `Illuminate\Support\Facades\Date`.

```diff
-use Carbon\Carbon;
+use Illuminate\Support\Facades\Date;

-Carbon::now();
-Carbon::parse('2024-01-01');
+Date::now();
+Date::parse('2024-01-01');
```

```diff
-use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\Date;

-Carbon::now();
-Carbon::today();
+Date::now();
+Date::today();
```

--------------------------------

### Configure AddArgumentDefaultValueRector with ADDED_ARGUMENTS

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Usage example showing how to register the rule with a configured array of AddArgumentDefaultValue objects, using the ADDED_ARGUMENTS key.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\ClassMethod\AddArgumentDefaultValueRector;
use RectorLaravel\ValueObject\AddArgumentDefaultValue;

return RectorConfig::configure()
    ->withConfiguredRule(AddArgumentDefaultValueRector::class, [
        AddArgumentDefaultValueRector::ADDED_ARGUMENTS => [
            new AddArgumentDefaultValue('SomeClass', 'someMethod', 0, false),
        ],
    ]);
```

--------------------------------

### Configure RenameStaticMethodRector with RenameStaticMethod

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules-map.md

Configures the RenameStaticMethodRector to rename a static method across classes. The example renames Input::get() to Request::input().

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\StaticCall\RenameStaticMethodRector;
use RectorLaravel\ValueObject\RenameStaticMethod;

return RectorConfig::configure()
    ->withConfiguredRule(RenameStaticMethodRector::class, [
        new RenameStaticMethod(
            'Illuminate\Support\Facades\Input',
            'get',
            'Illuminate\Support\Facades\Request',
            'input'
        ),
    ]);
```

--------------------------------

### Configure AddArgumentDefaultValueRector with shorthand shape

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Alternative usage example showing the shorthand configuration shape, passing a bare array of AddArgumentDefaultValue objects without the ADDED_ARGUMENTS key.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\ClassMethod\AddArgumentDefaultValueRector;
use RectorLaravel\ValueObject\AddArgumentDefaultValue;

return RectorConfig::configure()
    ->withConfiguredRule(AddArgumentDefaultValueRector::class, [
        new AddArgumentDefaultValue('App\SomeModel', 'method', 2, 'default'),
    ]);
```

--------------------------------

### MigrateToSimplifiedAttributeRector diff

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Migrates old accessor/mutator methods to the new simplified attribute syntax. The diff shows replacing get and set methods with a single protected method returning an Attribute.

```diff
 use Illuminate\Database\Eloquent\Model;

 class User extends Model
 {
-    public function getFirstNameAttribute($value)
+    protected function firstName(): \Illuminate\Database\Eloquent\Casts\Attribute
     {
-        return ucfirst($value);
-    }
-
-    public function setFirstNameAttribute($value)
-    {
-        $this->attributes['first_name'] = strtolower($value);
-        $this->attributes['first_name_upper'] = strtoupper($value);
+        return \Illuminate\Database\Eloquent\Casts\Attribute::make(get: function ($value) {
+            return ucfirst($value);
+        }, set: function ($value) {
+            return ['first_name' => strtolower($value), 'first_name_upper' => strtoupper($value)];
+        });
     }
 }
```

--------------------------------

### EmptyToBlankAndFilledFuncRector: Replace empty() with blank() and filled()

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Replaces the unsafe empty() function with Laravel's safer blank() and filled() functions. The example shows the transformation for empty([]) and !empty([]).

```diff
-empty([]);
-!empty([]);
+blank([]);
+filled([]);
```

--------------------------------

### ReplaceWithoutJobsEventsAndNotificationsWithFacadeFakeRector: Replace without methods with Facade fake

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Replaces `withoutJobs`, `withoutEvents`, and `withoutNotifications` with the corresponding Facade `fake` calls. Use this rule to update test setup to use Facade fakes.

```diff
-$this->withoutJobs();
-$this->withoutEvents();
-$this->withoutNotifications();
+\Illuminate\Support\Facades\Bus::fake();
+\Illuminate\Support\Facades\Event::fake();
+\Illuminate\Support\Facades\Notification::fake();
```

--------------------------------

### Configure Rector with Laravel sets

Source: https://github.com/driftingly/rector-laravel/blob/main/README.md

Use this PHP configuration to enable multiple Laravel sets in Rector. The example shows the LARAVEL_CODE_QUALITY and LARAVEL_COLLECTION sets, with a placeholder for additional sets.

```php
<?php declare(strict_types=1);

use Rector\Config\RectorConfig;
use RectorLaravel\Set\LaravelSetList;

return RectorConfig::configure()
    ->withSets([
        LaravelSetList::LARAVEL_CODE_QUALITY,
        LaravelSetList::LARAVEL_COLLECTION,
        ...
    ]);
```

--------------------------------

### EloquentMagicMethodToQueryBuilderRector: Convert magic method to query builder

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Transforms Eloquent magic method calls into explicit query builder calls. The example shows User::first() becoming User::query()->first().

```diff
 use App\Models\User;

-$user = User::first();
+$user = User::query()->first();
 $user = User::find(1);
```

--------------------------------

### Configure RemoveDumpDataDeadCodeRector in rector.php

Source: https://github.com/driftingly/rector-laravel/blob/main/README.md

Adds the RemoveDumpDataDeadCodeRector rule with a list of function names to remove. The default is ['dd', 'dump'], but this example configures it with 'dd', 'dump', and 'var_dump'.

```php
<?php declare(strict_types=1);

use Rector\Config\RectorConfig;
use RectorLaravel\Rector\FuncCall\RemoveDumpDataDeadCodeRector;

return RectorConfig::configure()
    ->withConfiguredRule(RemoveDumpDataDeadCodeRector::class, [
        'dd', 'dump', 'var_dump'
    ]);
```

--------------------------------

### RepositoryArrayAccessToMethodCallRector: Convert array access to method calls

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes array access on config or cache repositories to method calls because the contracts do not extend ArrayAccess. The diff shows replacements for get, set, has, and unset operations.

```diff
-$config['app.name'];
-$config['app.name'] = 'Foo';
-isset($config['app.name']);
-unset($config['app.name']);
+$config->get('app.name');
+$config->set('app.name', 'Foo');
+$config->has('app.name');
+$config->set('app.name');
```

--------------------------------

### Register ExampleRector in rector.php

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/abstract-rector.md

Shows how to register the custom rule in the Rector configuration file using withRules().

```php
use RectorLaravel\Rector\FuncCall\ExampleRector;

return RectorConfig::configure()
    ->withRules([ExampleRector::class]);
```

--------------------------------

### LumenRoutesStringActionToUsesArrayRector: Convert string action to array notation

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes action in rule definitions from string to array notation. The diff shows replacing the string 'UserController@get' with an array ['uses => 'UserController@get'].

```diff
-$router->get('/user', 'UserController@get');
+$router->get('/user', ['uses => 'UserController@get']);
```

--------------------------------

### Register node visitors as singletons in config/config.php

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/configuration.md

Registers the two decorating node visitors as Rector singletons so they decorate every corpus. Used in the extension's own config file.

```php
return static function (RectorConfig $rectorConfig): void {
    $rectorConfig->singleton(ArrayDimFetchContextNodeVisitor::class);
    $rectorConfig->singleton(RandomEnumContextNodeVisitor::class);
};
```

--------------------------------

### Recommended: withComposerBased auto-detection

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/set-lists.md

Use this recommended approach to automatically detect Laravel, Cashier, Faker, and Livewire sets based on composer dependencies. Requires the RectorConfig class.

```php
use Rector\Config\RectorConfig;

return RectorConfig::configure()
    ->withComposerBased(laravel: true, cashier: true, faker: true, livewire: true);
```

--------------------------------

### Configure WhereToWhereLikeRector for PostgreSQL with error handling

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Shows how to enable the Postgres driver behavior, which treats plain like/not like as case-sensitive and appends a true argument. Also demonstrates that configuring with an unknown key throws an InvalidArgumentException due to Assert::keyExists.

```php
use RectorLaravel\Rector\MethodCall\WhereToWhereLikeRector;

// $query->where('name', 'ilike', 'Rector');  =>  $query->whereLike('name', 'Rector');
$rector->configure([WhereToWhereLikeRector::USING_POSTGRES_DRIVER => true]);

try {
    $rector->configure(['unknown_key' => true]); // key missing
} catch (\Webmozart\Assert\InvalidArgumentException $e) {
    // Assert::keyExists — "Expected the key usingPostgresDriver to exist"
}
```

--------------------------------

### ArgumentFuncCallToMethodCallInterface

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/types.md

Interface that defines a method to get the function name that a rector should convert. Implemented by value objects used in Rector configuration.

```APIDOC
## ArgumentFuncCallToMethodCallInterface

### Description
Interface that defines a method to get the function name that a rector should convert. Implemented by value objects used in Rector configuration.

### Definition
```php
interface ArgumentFuncCallToMethodCallInterface
{
    public function getFunction(): string;
}
```

### Methods
- `getFunction(): string` - Returns the function name the rector should convert.

### Usage
- Accepted by `ArgumentFuncCallToMethodCallRector::configure(array $configuration): void` as `ArgumentFuncCallToMethodCallInterface[]`.
- Implemented by `ArgumentFuncCallToMethodCall` and `ArrayFuncCallToMethodCall`.
```

--------------------------------

### Manual set selection with withSets

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/configuration.md

Deprecated for version sets. Manually selects cumulative version sets and topic sets using LaravelLevelSetList and LaravelSetList constants.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Set\LaravelSetList;
use RectorLaravel\Set\LaravelLevelSetList;

return RectorConfig::configure()
    ->withSets([
        LaravelLevelSetList::UP_TO_LARAVEL_130,   // cumulative versions up to 13.0
        LaravelSetList::LARAVEL_TESTING,          // topic set
    ]);
```

--------------------------------

### RedirectRouteToToRouteHelperRector: Replace redirect()->route() and Redirect::route() with to_route()

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Replaces both `redirect()->route('home')` and `Redirect::route('home')` calls with `to_route('home')` in a class. The diff shows the before and after for two methods, `store()` and `update()`, including the `with()` chained call. The `use Illuminate\Support\Facades\Redirect;` import is preserved in the diff.

```diff
 use Illuminate\Support\Facades\Redirect;

 class MyController
 {
     public function store()
     {
-        return redirect()->route('home')->with('error', 'Incorrect Details.')
+        return to_route('home')->with('error', 'Incorrect Details.')
     }

     public function update()
     {
-        return Redirect::route('home')->with('error', 'Incorrect Details.')
+        return to_route('home')->with('error', 'Incorrect Details.')
     }
 }
```

--------------------------------

### FactoryApplyingStatesRector: Call state methods directly

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Replaces calls to state() and states() with direct method calls on the factory. The diff shows the before and after code.

```diff
-$factory->state('delinquent');
-$factory->states('premium', 'delinquent');
+$factory->delinquent();
+$factory->premium()->delinquent();
```

--------------------------------

### NowFuncWithStartOfDayMethodCallToTodayFuncRector: Use today() instead of now()->startOfDay()

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Replaces `now()->startOfDay()` with `today()`. The diff shows the before and after code.

```diff
-$now = now()->startOfDay();
+$now = today();
```

--------------------------------

### Topic sets combine freely: LaravelSetList constants

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/set-lists.md

Combine topic-specific sets (code quality, collection, testing, type declarations) freely using LaravelSetList constants in withSets.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Set\LaravelSetList;

return RectorConfig::configure()
    ->withSets([
        LaravelSetList::LARAVEL_CODE_QUALITY,
        LaravelSetList::LARAVEL_COLLECTION,
        LaravelSetList::LARAVEL_TESTING,
        LaravelSetList::LARAVEL_TYPE_DECLARATIONS,
    ]);
```

--------------------------------

### configure(array $configuration): void

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Configures the rule with optional namespace and routes overrides. Validates the configuration and throws an exception if invalid.

```APIDOC
## configure(array $configuration): void

### Description
Configures the rule with optional namespace and routes overrides. Validates the configuration and throws an exception if invalid.

### Method
configure

### Parameters
- **configuration** (array) - Required - The configuration array with keys `routes` and `namespace`.

### Configuration Keys
- **routes** (`self::ROUTES`) (array<string, string>) - Optional - Per-file namespace overrides: file path → namespace.
- **namespace** (`self::NAMESPACE`) (string) - Optional - Default controller namespace. Defaults to `'App\Http\Controllers'`.

### Validation
- `routes` must be an array whose keys and values are strings.
- `namespace` must be a string.

### Throws
- `Webmozart\Assert\InvalidArgumentException` if validation fails.
```

--------------------------------

### Manual sets (deprecated path): LaravelLevelSetList::UP_TO_LARAVEL_130

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/set-lists.md

Deprecated manual configuration using LaravelLevelSetList to upgrade to Laravel 130. Use withSets with the level set list.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Set\LaravelLevelSetList;
use RectorLaravel\Set\LaravelSetList;

return RectorConfig::configure()
    ->withSets([
        LaravelLevelSetList::UP_TO_LARAVEL_130,
    ]);
```

--------------------------------

### CallUserFuncAnalyzer class definition

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/node-analyzers.md

Final readonly class with constructor-injected NodeNameResolver and NodeTypeResolver. Provides methods to detect call_user_func/call_user_func_array calls, determine if a method can be resolved from a callable, and get the forwarded method as a ForwardingCall.

```php
final readonly class CallUserFuncAnalyzer
{
    public function __construct(
        private NodeNameResolver $nodeNameResolver,
        private NodeTypeResolver $nodeTypeResolver,
    ) {}

    public function isCallUserFuncCall(FuncCall $funcCall): bool
    public function canDetermineMethodFromCallable(FuncCall $funcCall): bool
    public function getForwardedMethod(FuncCall $funcCall): ?ForwardingCall
}
```

--------------------------------

### ArgumentFuncCallToMethodCallRector: Move view() to constructor injection

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Moves help facade-like function calls to constructor injection. The diff shows adding a `$viewFactory` property and constructor, and changing `view('template.blade')` to `$this->viewFactory->make('template.blade')`.

```diff
 class SomeController
 {
+    /**
+     * @var \Illuminate\Contracts\View\Factory
+     */
+    private $viewFactory;
+
+    public function __construct(\Illuminate\Contracts\View\Factory $viewFactory)
+    {
+        $this->viewFactory = $viewFactory;
+    }
+
     public function action()
     {
-        $template = view('template.blade');
-        $viewFactory = view();
+        $template = $this->viewFactory->make('template.blade');
+        $viewFactory = $this->viewFactory;
     }
 }
```

--------------------------------

### LivewireComponentComputedMethodToComputedAttributeRector: Convert computed methods to #[Computed] attribute

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Converts the computed methods of a Livewire component to use the Computed Attribute. The example shows changing a getFooBarProperty method to a fooBar method with the #\Livewire\Attributes\Computed attribute.

```diff
 use Livewire\Component;

 class MyComponent extends Component
 {
-    public function getFooBarProperty()
+    #\Livewire\Attributes\Computed
+    public function fooBar()
     {
     }
 }

```

--------------------------------

### UseComponentPropertyWithinCommandsRector: Use $this->components in commands

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Use the $this->components property within commands. The diff shows replacing $this->ask(), $this->line(), $this->info(), and $this->error() with $this->components->ask(), $this->components->line(), $this->components->info(), and $this->components->error() inside a command class.

```diff
 use Illuminate\Console\Command;

 class CommandWithComponents extends Command
 {
     public function handle()
     {
-        $this->ask('What is your name?');
-        $this->line('A line!');
-        $this->info('Info!');
-        $this->error('Error!');
+        $this->components->ask('What is your name?');
+        $this->components->line('A line!');
+        $this->components->info('Info!');
+        $this->components->error('Error!');
     }
 }
```

--------------------------------

### EloquentWhereTypeHintClosureParameterRector: Add type hint to closure parameter in where method (Eloquent Builder)

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes the closure parameter type hint in the where method of Eloquent or Query Builder. This example targets the Eloquent Builder contract.

```diff
 /** @var \Illuminate\Contracts\Database\Eloquent\Builder $query */
-$query->where(function ($query) {
+$query->where(function (\Illuminate\Contracts\Database\Eloquent\Builder $query) {
     $query->where('id', 1);
 });
```

--------------------------------

### EloquentWhereTypeHintClosureParameterRector: Add type hint to closure parameter in where method (Query Builder)

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes the closure parameter type hint in the where method of Eloquent or Query Builder. This example targets the Query Builder contract.

```diff
 /** @var \Illuminate\Contracts\Database\Query\Builder $query */
-$query->where(function ($query) {
+$query->where(function (\Illuminate\Contracts\Database\Query\Builder $query) {
     $query->where('id', 1);
 });
```

--------------------------------

### HelperFuncCallToFacadeClassRector: Convert app() helper to facade call

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes app('translator') helper calls to use the App facade's make() method. The diff shows replacing the helper call with the facade call.

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

--------------------------------

### Invalid configuration rejected: namespace must be a string

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Shows that passing a non-string value for the `namespace` key throws an `InvalidArgumentException` via Webmozart Assert. The comment indicates the expected failure.

```php
// namespace must be a string
$rector->configure([RouteActionCallableRector::NAMESPACE => 42]); // throws InvalidArgumentException (Assert::string)
```

--------------------------------

### Catch InvalidArgumentException during rule configuration

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules-map.md

Wrap the configuration build in a try/catch to handle violations. All configure() methods throw Webmozart\Assert\InvalidArgumentException on violations, with messages like 'Expected all values to be instance of ...', 'Expected all values to be string', 'Expected the key <KEY> to exist', or 'Expected a boolean'.

```php
use Webmozart\Assert\InvalidArgumentException;

try {
    $config = RectorConfig::configure()
        ->withConfiguredRule(SomeConfigurableRector::class, $badPayload);
} catch (InvalidArgumentException $e) {
    // log/abort — configuration is invalid
}
```

--------------------------------

### ChangeQueryWhereDateValueWithCarbonRector: Refactor whereDate() with Carbon

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Refactor `whereDate()` queries to include both date and time comparisons with Carbon. The example shows replacing a single `whereDate` call with a `whereDate` and `whereTime` pair using a Carbon instance.

```diff
 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);
     }
 }
```

--------------------------------

### configure(array $configuration): void

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Configures the rule with an optional `usingPostgresDriver` flag. An empty array resets the flag to false; otherwise the configuration must contain the `USING_POSTGRES_DRIVER` boolean key.

```APIDOC
## configure(array $configuration): void

### Description
Configures the rule with an optional `usingPostgresDriver` flag. An empty array resets the flag to false; otherwise the configuration must contain the `USING_POSTGRES_DRIVER` boolean key.

### Method
configure

### Parameters
- **configuration** (array) - Required - Empty array resets to `false`; otherwise must contain `USING_POSTGRES_DRIVER` boolean key.

### Behavior
- `configuration === []` → `usingPostgresDriver = false` (and returns early).
- Otherwise `Assert::keyExists($configuration, USING_POSTGRES_DRIVER)` and `Assert::boolean(...)` apply.
- With `USING_POSTGRES_DRIVER = true`, plain `like`/`not like` are treated as case-sensitive (`ilike` is read in Postgres), so a `true` case-sensitivity argument is appended.
```

--------------------------------

### RemoveDumpDataDeadCodeRector config validation error handling

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Shows that configure() throws Webmozart\Assert\InvalidArgumentException when a non-string element is passed, e.g., [123]. The error message is 'Expected all values to be string'.

```php
use RectorLaravel\Rector\FuncCall\RemoveDumpDataDeadCodeRector;

try {
    $rector->configure([123]); // non-string element
} catch (\Webmozart\Assert\InvalidArgumentException $e) {
    // "Expected all values to be string" — configuration rejected
}
```

--------------------------------

### JsonCallToExplicitJsonCallRector: Replace $this->json with explicit methods

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes method calls from $this->json to explicit methods like $this->postJson, $this->putJson, etc. The example shows converting $this->json("POST", ...) to $this->postJson(...).

```diff
-$this->json("POST", "/api/v1/users", $data);
+$this->postJson("/api/v1/users", $data);

```

--------------------------------

### AppEnvironmentComparisonToParameterRector: Replace environment comparisons

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Replaces `environment()` comparisons with parameter or method calls. The diff shows the before and after for four cases.

```diff
-$app->environment() === 'local';
-$app->environment() !== 'production';
-$app->environment() === 'testing';
-in_array($app->environment(), ['local', 'testing']);
+$app->isLocal();
+! $app->isProduction();
+$app->environment('testing');
+$app->environment(['local', 'testing']);
```

--------------------------------

### Manual configuration with LaravelLevelSetList

Source: https://github.com/driftingly/rector-laravel/blob/main/README.md

Deprecated manual configuration using LaravelLevelSetList to pick a version set.

```php
<?php declare(strict_types=1);

use Rector\Config\RectorConfig;
use RectorLaravel\Set\LaravelLevelSetList;

return RectorConfig::configure()
    ->withSets([
        LaravelLevelSetList::UP_TO_LARAVEL_130,
    ]);
```

--------------------------------

### Basic configuration with default namespace

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Configures the rule with only the default controller namespace. The `namespace` key is optional and defaults to `'App\Http\Controllers'`.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\StaticCall\RouteActionCallableRector;

return RectorConfig::configure()
    ->withConfiguredRule(RouteActionCallableRector::class, [
        RouteActionCallableRector::NAMESPACE => 'App\Http\Controllers',
    ]);
```

--------------------------------

### File-specific namespaces plus default, fully configured

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Configures the rule with both a default namespace and per-file namespace overrides. The `routes` key maps file paths to namespaces, overriding the default for those files.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\StaticCall\RouteActionCallableRector;

return RectorConfig::configure()
    ->withConfiguredRule(RouteActionCallableRector::class, [
        RouteActionCallableRector::NAMESPACE => 'App\Http\Controllers',
        RouteActionCallableRector::ROUTES => [
            '/abs/path/app/Http/Controllers/Api/routes.php' => 'App\Http\Controllers\Api',
            '/abs/path/app/Http/Controllers/Admin/routes.php' => 'App\Http\Controllers\Admin',
        ],
    ]);
```

--------------------------------

### AppToResolveRector: Convert app() to resolve()

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Use this rule to replace `app()` calls with `resolve()` where applicable. The diff shows the transformation from `app('foo')` to `resolve('foo')`.

```diff
-app('foo');
+resolve('foo');
```

--------------------------------

### LumenRoutesStringMiddlewareToArrayRector: Convert string middleware to array notation

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes middlewares from rule definitions from string to array notation. The diff shows converting 'test' to ['test'] and 'test|authentication' to ['test', 'authentication'].

```diff
-$router->get('/user', ['middleware => 'test']);
-$router->post('/user', ['middleware => 'test|authentication']);
+$router->get('/user', ['middleware => ['test']]);
+$router->post('/user', ['middleware => ['test', 'authentication']]);
```

--------------------------------

### Configure WhereToWhereLikeRector for MySQL/standard driver

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Registers the rule with USING_POSTGRES_DRIVER set to false, which is the default behavior for MySQL and other standard drivers. The comment shows the transformation from where('name', 'like', 'Rector') to whereLike('name', 'Rector').

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\MethodCall\WhereToWhereLikeRector;

// $query->where('name', 'like', 'Rector');  =>  $query->whereLike('name', 'Rector');
return RectorConfig::configure()
    ->withConfiguredRule(WhereToWhereLikeRector::class, [
        WhereToWhereLikeRector::USING_POSTGRES_DRIVER => false,
    ]);
```

--------------------------------

### CommandPropertyToAsCommandAttributeRector

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes the name/signature and description properties of a console command to the AsCommand attribute.

```diff
 use Illuminate\Console\Command;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputOption;

+#[AsCommand(name: 'mail:send', description: 'Send the queued emails')]
 class SendEmails extends Command
 {
-    protected $signature = 'mail:send {user} {--queue}';
+    protected function getArguments(): array
+    {
+        return [new InputArgument('user', InputArgument::REQUIRED)];
+    }

-    protected $description = 'Send the queued emails';
+    protected function getOptions(): array
+    {
+        return [new InputOption('queue', null, InputOption::VALUE_NONE)];
+    }
 }
```

--------------------------------

### LivewireComponentQueryStringToUrlAttributeRector: Convert $queryString to Url Attribute

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Converts the $queryString property of a Livewire component to use the Url Attribute. The diff shows adding #[\Livewire\Attributes\Url] to each public property and removing the protected $queryString array.

```diff
 use Livewire\Component;

 class MyComponent extends Component
 {
+    #[\Livewire\Attributes\Url]
     public string $something = '';

+    #[\Livewire\Attributes\Url]
     public string $another = '';
-
-    protected $queryString = [
-        'something',
-        'another',
-    ];
 }
```

--------------------------------

### ExampleRector class implementing AbstractRector

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/abstract-rector.md

Defines the mandatory methods for a custom Rector rule: getRuleDefinition() returns a RuleDefinition with a code sample, getNodeTypes() specifies the node types to match, and refactor() returns a new node, null, or NodeVisitor::REMOVE_NODE. The class extends AbstractRector from RectorLaravel.

```php
<?php

declare(strict_types=1);

namespace RectorLaravel\Rector\FuncCall;

use PhpParser\Node;
use PhpParser\Node\Stmt\Expression;
use RectorLaravel\AbstractRector;
use Symplify\RuleDocGenerator\ValueObject\CodeSample\CodeSample;
use Symplify\RuleDocGenerator\ValueObject\RuleDefinition;

final class ExampleRector extends AbstractRector
{
    public function getRuleDefinition(): RuleDefinition
    {
        return new RuleDefinition('Replaces old() with new().', [
            new CodeSample('old(1);', 'new(1);'),
        ]);
    }

    /** @return array<class-string<Node>> */
    public function getNodeTypes(): array
    {
        return [Expression::class];
    }

    public function refactor(Node $node): ?Node
    {
        // ... return $newNode | null | NodeVisitor::REMOVE_NODE
    }
}
```

--------------------------------

### Add opinionated rules with withRules

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/configuration.md

Registers extra opinionated rules, such as ResponseHelperCallToJsonResponseRector, using withRules.

```php
use Rector\Config\RectorConfig;
use RectorLaravel\Rector\MethodCall\ResponseHelperCallToJsonResponseRector;

return RectorConfig::configure()
    ->withRules([ResponseHelperCallToJsonResponseRector::class]);
```

--------------------------------

### RequestVariablesToRequestFacadeRector: Replace superglobals with Request facade

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes $_GET, $_POST, and $_REQUEST variable access to corresponding Request facade methods. The diff shows replacements for query, post, input, all, and exists.

```diff
-$_GET['value'];
-$_POST['value'];
-$_REQUEST['value'];
-$_POST;
-$_GET;
-$_REQUEST;
-isset($_GET['value']);
-isset($_POST['value']);
-isset($_REQUEST['value']);
+\Illuminate\Support\Facades\Request::query('value');
+\Illuminate\Support\Facades\Request::post('value');
+\Illuminate\Support\Facades\Request::input('value');
+\Illuminate\Support\Facades\Request::query();
+\Illuminate\Support\Facades\Request::post();
+\Illuminate\Support\Facades\Request::all();
+\Illuminate\Support\Facades\Request::query('value') !== null;
+\Illuminate\Support\Facades\Request::post('value') !== null;
+\Illuminate\Support\Facades\Request::exists('value');
```

--------------------------------

### DispatchableTestsMethodsFactory class definition

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/node-factories-and-visitors.md

Class with methods makeFacadeFakeCall, assertStatements, and assertNotStatements for generating facade fake calls and assertions. Used by ReplaceWithoutJobsEventsAndNotificationsWithFacadeFakeRector.

```php
final class DispatchableTestsMethodsFactory
{
    /**
     * @param  array<int<0, max>, ClassConstFetch|String_>  $items
     */
    public function makeFacadeFakeCall(array $items, string $facade): StaticCall

    /** @param  array<int<0, max>, ClassConstFetch|String_>  $items
     *  @return Expression[] */
    public function assertStatements(array $items, string $facade): array

    /** @param  array<int<0, max>, ClassConstFetch|String_>  $items
     *  @return Expression[] */
    public function assertNotStatements(array $items, string $facade): array
}
```

--------------------------------

### ResponseHelperCallToJsonResponseRector: Replace response()->json() with JsonResponse

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Use new JsonResponse instead of `response()->json()`. The diff shows the before and after transformation.

```diff
-response()->json(['key' => 'value']);
+return new JsonResponse(['key' => 'value']);
```

--------------------------------

### FactoryDefinitionRector: Upgrade legacy factories to support classes

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Transforms a legacy factory definition using the global `factory()->define()` into a new-style factory class extending `Illuminate\Database\Eloquent\Factories\Factory`. The new class sets the `$model` property and defines a `definition()` method using `$this->faker`.

```diff
 use Faker\Generator as Faker;

-$factory->define(App\User::class, function (Faker $faker) {
-    return [
-        'name' => $faker->name,
-        'email' => $faker->unique()->safeEmail,
-    ];
-});
+class UserFactory extends \Illuminate\Database\Eloquent\Factories\Factory
+{
+    protected $model = App\User::class;
+    public function definition()
+    {
+        return [
+            'name' => $this->faker->name,
+            'email' => $this->faker->unique()->safeEmail,
+        ];
+    }
+}
```

--------------------------------

### Create a rule in a subdirectory with composer make:rule

Source: https://github.com/driftingly/rector-laravel/blob/main/README.md

Include slashes in the rule name to specify a subdirectory structure. This creates the rule in src/Rector/If_/ with the namespace RectorLaravel\Rector\If_.

```bash
composer make:rule -- If_/ConvertIfToWhen
```

--------------------------------

### DatabaseExpressionCastsToMethodCallRector: Convert DB Expression string casts to getValue()

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Replaces string casts of DB::raw() expressions with getValue() calls using the query grammar. The diff shows the before and after code.

```diff
 use Illuminate\Support\Facades\DB;

-$string = (string) DB::raw('select 1');
+$string = DB::raw('select 1')->getValue(DB::connection()->getQueryGrammar());
```

--------------------------------

### ConfigToTypedConfigMethodCallRector

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Refactor config() calls to use type-specific methods when the expected type is known.

```diff
-$name = (string) config('app.name');
-$lifetime = (int) config('session.lifetime');
-$debug = (bool) config('app.debug');
-$version = (float) config('app.version');
-$connections = (array) config('database.connections');
+$name = config()->string('app.name');
+$lifetime = config()->integer('session.lifetime');
+$debug = config()->boolean('app.debug');
+$version = config()->float('app.version');
+$connections = config()->array('database.connections');
```

--------------------------------

### AppAssignFactory class definition

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/node-factories-and-visitors.md

Final readonly class with a constructor injecting PhpDocInfoFactory and a method createAssignExpression that builds an assignment expression with a PHPDoc tag. Used by CallOnAppArrayAccessToStandaloneAssignRector.

```php
final readonly class AppAssignFactory
{
    public function __construct(
        private PhpDocInfoFactory $phpDocInfoFactory
    ) {}

    public function createAssignExpression(
        ServiceNameTypeAndVariableName $serviceNameTypeAndVariableName,
        Expr $expr
    ): Expression
}
```

--------------------------------

### Add parent::boot() call to model boot method

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Adds `parent::boot();` call to the `boot()` class method in child classes of `Illuminate\Database\Eloquent\Model`. The diff shows adding the call inside the method.

```diff
 use Illuminate\Database\Eloquent\Model;

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

--------------------------------

### DispatchToHelperFunctionsRector: Replace static dispatch with helper functions

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Converts static dispatch and broadcast calls to Laravel helper functions. Handles event, dispatch, dispatchSync, and broadcast methods.

```diff
-ExampleEvent::dispatch($email);
+event(new ExampleEvent($email));
```

```diff
-ExampleJob::dispatch($email);
+dispatch(new ExampleJob($email));
```

```diff
-ExampleJob::dispatchSync($email);
+dispatch_sync(new ExampleJob($email));
```

```diff
-ExampleEvent::broadcast($email);
+broadcast(new ExampleEvent($email));
```

--------------------------------

### HelpPropertyToHelpAttributeRector: Convert help property to attribute

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes the command's $help property to use the #[Help] attribute. The diff shows adding the Help attribute import and applying it to the class, while removing the property.

```diff
 use Illuminate\Console\Command;
+use Illuminate\Console\Attributes\Help;

+#[Help('This command sends emails to all users')]
 class SendEmails extends Command
 {
-    protected $help = 'This command sends emails to all users';
 }
```

--------------------------------

### NotFilledBlankFuncCallToBlankFilledFuncCallRector: Swap !filled() and !blank()

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Swaps the use of `!filled()` and `!blank()` to the correct helper functions `blank()` and `filled()`. The diff shows the before and after code.

```diff
-!filled([]);
-!blank([]);
+blank([]);
+filled([]);
```

--------------------------------

### AddArgumentDefaultValueRector::configure(array $configuration): void

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/api-reference/configurable-rules.md

Configures the rule with an array of AddArgumentDefaultValue objects. Accepts either a keyed array with 'added_arguments' or a bare array of value objects.

```APIDOC
## configure(array $configuration): void

### Description
Configures the rule with an array of AddArgumentDefaultValue objects. Accepts either a keyed array with 'added_arguments' or a bare array of value objects.

### Method
configure

### Parameters
- **configuration** (array) - Required - Either `[self::ADDED_ARGUMENTS => AddArgumentDefaultValue[]]` or a bare `AddArgumentDefaultValue[]`.

### Validation
- Asserts that the configuration is an array and all elements are instances of AddArgumentDefaultValue.
```

--------------------------------

### StaticCallToMethodCall Value Object Definition

Source: https://github.com/driftingly/rector-laravel/blob/main/_autodocs/types.md

Defines a value object for mapping static facade calls to service method calls. Used by StaticFacadeToServiceMethodCallRector::configure() and the LARAVEL_STATIC_TO_INJECTION set. The constructor takes staticClass, staticMethod, classType, and methodName, where '*' in staticMethod or methodName matches all methods.

```php
final readonly class StaticCallToMethodCall
{
    public function __construct(
        private string $staticClass,
        private string $staticMethod,
        private string $classType,
        private string $methodName
    ) {}

    public function getClassObjectType(): ObjectType
    public function getClassType(): string
    public function getMethodName(): string
    public function isStaticCallMatch(StaticCall $staticCall): bool
}
```

--------------------------------

### StaticFacadeToServiceMethodCallRector: Convert static facade call to service method via constructor injection

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Changes a static facade call to a service method using constructor injection. The diff adds a constructor with AuthManager and changes the method body to use $this->authManager->user().

```diff
 class SomeController
 {
+    public function __construct(private readonly \Illuminate\Auth\AuthManager $authManager)
+    {
+    }
     public function store()
     {
-        return \Illuminate\Support\Facades\Auth::user();
+        return $this->authManager->user();
     }
 }

```

--------------------------------

### SubStrToStartsWithOrEndsWithStaticMethodCallRector: Replace substr with Str::startsWith

Source: https://github.com/driftingly/rector-laravel/blob/main/docs/rector_rules_overview.md

Use Str::startsWith() or Str::endsWith() instead of substr() === $str. The rule converts a substr comparison to a Laravel string helper.

```diff
-if (substr($str, 0, 3) === 'foo') {
+if (Str::startsWith($str, 'foo')) {
     // do something
 }
```
Tokens:
Raw