Add Laravel 13 ObservedBy observer migration rectors

config/sets/laravel130-attributes.php

@@ -22,6 +22,7 @@
 use RectorLaravel\Rector\Class_\HiddenPropertyToHiddenAttributeRector;
 use RectorLaravel\Rector\Class_\JobConnectionPropertyToJobConnectionAttributeRector;
 use RectorLaravel\Rector\Class_\MaxExceptionsPropertyToMaxExceptionsAttributeRector;
+use RectorLaravel\Rector\Class_\ObserveCallsToObservedByAttributeRector;
 use RectorLaravel\Rector\Class_\PreserveKeysPropertyToPreserveKeysAttributeRector;
 use RectorLaravel\Rector\Class_\QueuePropertyToQueueAttributeRector;
 use RectorLaravel\Rector\Class_\SignaturePropertyToSignatureAttributeRector;
@@ -34,6 +35,7 @@
 use RectorLaravel\Rector\Class_\VisiblePropertyToVisibleAttributeRector;
 use RectorLaravel\Rector\Class_\WithoutIncrementingPropertyToWithoutIncrementingAttributeRector;
 use RectorLaravel\Rector\Class_\WithoutTimestampsPropertyToWithoutTimestampsAttributeRector;
+use RectorLaravel\Rector\ClassMethod\RemoveModelObserveCallsFromBootRector;
 
 return static function (RectorConfig $rectorConfig): void {
     $rectorConfig->import(__DIR__ . '/../config.php');
@@ -53,6 +55,8 @@
     $rectorConfig->rule(FillablePropertyToFillableAttributeRector::class);
     $rectorConfig->rule(GuardedPropertyToGuardedAttributeRector::class);
     $rectorConfig->rule(HiddenPropertyToHiddenAttributeRector::class);
+    $rectorConfig->rule(ObserveCallsToObservedByAttributeRector::class);
+    $rectorConfig->rule(RemoveModelObserveCallsFromBootRector::class);
     $rectorConfig->rule(TablePropertyToTableAttributeRector::class);
     $rectorConfig->rule(TouchesPropertyToTouchesAttributeRector::class);
     $rectorConfig->rule(VisiblePropertyToVisibleAttributeRector::class);

docs/rector_rules_overview.md

@@ -1,4 +1,4 @@
-# 106 Rules Overview
+# 108 Rules Overview
 
 ## AbortIfRector
 
@@ -1284,6 +1284,25 @@ Swap the use of NotBooleans used with `filled()` and `blank()` to the correct he
 
 <br>
 
+## ObserveCallsToObservedByAttributeRector
+
+Changes manual model `observe()` registrations in boot methods to use the `ObservedBy` attribute
+
+- class: [`RectorLaravel\Rector\Class_\ObserveCallsToObservedByAttributeRector`](../src/Rector/Class_/ObserveCallsToObservedByAttributeRector.php)
+
+```diff
+ use App\Observers\UserObserver;
++use Illuminate\Database\Eloquent\Attributes\ObservedBy;
+ use Illuminate\Foundation\Auth\User as Authenticatable;
+
++#[ObservedBy([UserObserver::class])]
+ class User extends Authenticatable
+ {
+ }
+```
+
+<br>
+
 ## NowFuncWithStartOfDayMethodCallToTodayFuncRector
 
 Use `today()` instead of `now()->startOfDay()`
@@ -1357,6 +1376,28 @@ Changes the queue property to use the Queue attribute
 
 <br>
 
+## RemoveModelObserveCallsFromBootRector
+
+Removes direct model `observe()` registrations from boot methods when they can be represented by `ObservedBy`
+
+- class: [`RectorLaravel\Rector\ClassMethod\RemoveModelObserveCallsFromBootRector`](../src/Rector/ClassMethod/RemoveModelObserveCallsFromBootRector.php)
+
+```diff
+ use App\Models\User;
+ use App\Observers\UserObserver;
+
+ class AppServiceProvider
+ {
+     public function boot(): void
+     {
+-        User::observe(UserObserver::class);
+         $this->bootSomethingElse();
+     }
+ }
+```
+
+<br>
+
 ## Redirect301ToPermanentRedirectRector
 
 Change "redirect" call with 301 to "permanentRedirect"