event name & listener callback types (#53642)

* event name & listener callback types

* formatting

* formatting

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: rudiedirkx

src/Illuminate/Database/Eloquent/Concerns/HasEvents.php

@@ -183,7 +183,7 @@ public function removeObservableEvents($observables)
      * Register a model event with the dispatcher.
      *
      * @param  string  $event
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     protected static function registerModelEvent($event, $callback)
@@ -266,7 +266,7 @@ protected function filterModelEventResults($result)
     /**
      * Register a retrieved model event with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     public static function retrieved($callback)
@@ -277,7 +277,7 @@ public static function retrieved($callback)
     /**
      * Register a saving model event with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     public static function saving($callback)
@@ -288,7 +288,7 @@ public static function saving($callback)
     /**
      * Register a saved model event with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     public static function saved($callback)
@@ -299,7 +299,7 @@ public static function saved($callback)
     /**
      * Register an updating model event with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     public static function updating($callback)
@@ -310,7 +310,7 @@ public static function updating($callback)
     /**
      * Register an updated model event with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     public static function updated($callback)
@@ -321,7 +321,7 @@ public static function updated($callback)
     /**
      * Register a creating model event with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     public static function creating($callback)
@@ -332,7 +332,7 @@ public static function creating($callback)
     /**
      * Register a created model event with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     public static function created($callback)
@@ -343,7 +343,7 @@ public static function created($callback)
     /**
      * Register a replicating model event with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     public static function replicating($callback)
@@ -354,7 +354,7 @@ public static function replicating($callback)
     /**
      * Register a deleting model event with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     public static function deleting($callback)
@@ -365,7 +365,7 @@ public static function deleting($callback)
     /**
      * Register a deleted model event with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string  $callback
      * @return void
      */
     public static function deleted($callback)

src/Illuminate/Database/Eloquent/SoftDeletes.php

@@ -210,7 +210,7 @@ public function trashed()
     /**
      * Register a "softDeleted" model event callback with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|class-string  $callback
      * @return void
      */
     public static function softDeleted($callback)
@@ -221,7 +221,7 @@ public static function softDeleted($callback)
     /**
      * Register a "restoring" model event callback with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|class-string  $callback
      * @return void
      */
     public static function restoring($callback)
@@ -232,7 +232,7 @@ public static function restoring($callback)
     /**
      * Register a "restored" model event callback with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|class-string  $callback
      * @return void
      */
     public static function restored($callback)
@@ -243,7 +243,7 @@ public static function restored($callback)
     /**
      * Register a "forceDeleting" model event callback with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|class-string  $callback
      * @return void
      */
     public static function forceDeleting($callback)
@@ -254,7 +254,7 @@ public static function forceDeleting($callback)
     /**
      * Register a "forceDeleted" model event callback with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string  $callback
+     * @param  \Illuminate\Events\QueuedClosure|callable|class-string  $callback
      * @return void
      */
     public static function forceDeleted($callback)

src/Illuminate/Events/Dispatcher.php

@@ -80,8 +80,8 @@ public function __construct(?ContainerContract $container = null)
     /**
      * Register an event listener with the dispatcher.
      *
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array  $events
-     * @param  \Illuminate\Events\QueuedClosure|\Closure|string|array|null  $listener
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string|string  $events
+     * @param  \Illuminate\Events\QueuedClosure|callable|array|class-string|null  $listener
      * @return void
      */
     public function listen($events, $listener = null)

src/Illuminate/Support/Facades/Event.php

@@ -6,7 +6,7 @@
 use Illuminate\Support\Testing\Fakes\EventFake;
 
 /**
- * @method static void listen(\Illuminate\Events\QueuedClosure|\Closure|string|array $events, \Illuminate\Events\QueuedClosure|\Closure|string|array|null $listener = null)
+ * @method static void listen(\Illuminate\Events\QueuedClosure|callable|array|class-string|string $events, \Illuminate\Events\QueuedClosure|callable|array|class-string|null $listener = null)
  * @method static bool hasListeners(string $eventName)
  * @method static bool hasWildcardListeners(string $eventName)
  * @method static void push(string $event, object|array $payload = [])