[12.x] Improve PHPDoc blocks for array of arguments in Gate (#56426)

shaedrich · web-flow · commit b39a756d8ed3 · 2025-07-26T08:32:25.000-06:00
* Improve PHPDoc blocks for array of arguments

* StyleCI

* Add generics
diff --git a/src/Illuminate/Auth/Access/Gate.php b/src/Illuminate/Auth/Access/Gate.php
@@ -18,6 +18,9 @@
 
 use function Illuminate\Support\enum_value;
 
+/**
+ * @template TClass of object
+ */
 class Gate implements GateContract
 {
     use HandlesAuthorization;
@@ -326,7 +329,7 @@ public function after(callable $callback)
      * Determine if all of the given abilities should be granted for the current user.
      *
      * @param  iterable|\UnitEnum|string  $ability
-     * @param  mixed  $arguments
+     * @param  array{class-string<TClass>|TClass, ...}  $arguments
      * @return bool
      */
     public function allows($ability, $arguments = [])
@@ -338,7 +341,7 @@ public function allows($ability, $arguments = [])
      * Determine if any of the given abilities should be denied for the current user.
      *
      * @param  iterable|\UnitEnum|string  $ability
-     * @param  mixed  $arguments
+     * @param  array{class-string<TClass>|TClass, ...}  $arguments
      * @return bool
      */
     public function denies($ability, $arguments = [])
@@ -350,7 +353,7 @@ public function denies($ability, $arguments = [])
      * Determine if all of the given abilities should be granted for the current user.
      *
      * @param  iterable|\UnitEnum|string  $abilities
-     * @param  mixed  $arguments
+     * @param  array{class-string<TClass>|TClass, ...}  $arguments
      * @return bool
      */
     public function check($abilities, $arguments = [])
@@ -364,7 +367,7 @@ public function check($abilities, $arguments = [])
      * Determine if any one of the given abilities should be granted for the current user.
      *
      * @param  iterable|\UnitEnum|string  $abilities
-     * @param  mixed  $arguments
+     * @param  array{class-string<TClass>|TClass, ...}  $arguments
      * @return bool
      */
     public function any($abilities, $arguments = [])
@@ -376,7 +379,7 @@ public function any($abilities, $arguments = [])
      * Determine if all of the given abilities should be denied for the current user.
      *
      * @param  iterable|\UnitEnum|string  $abilities
-     * @param  mixed  $arguments
+     * @param  array{class-string<TClass>|TClass, ...}  $arguments
      * @return bool
      */
     public function none($abilities, $arguments = [])
@@ -388,7 +391,7 @@ public function none($abilities, $arguments = [])
      * Determine if the given ability should be granted for the current user.
      *
      * @param  \UnitEnum|string  $ability
-     * @param  mixed  $arguments
+     * @param  array{class-string<TClass>|TClass, ...}  $arguments
      * @return \Illuminate\Auth\Access\Response
      *
      * @throws \Illuminate\Auth\Access\AuthorizationException
@@ -402,7 +405,7 @@ public function authorize($ability, $arguments = [])
      * Inspect the user for the given ability.
      *
      * @param  \UnitEnum|string  $ability
-     * @param  array|mixed  $arguments
+     * @param  array{class-string<TClass>|TClass, ...}  $arguments
      * @return \Illuminate\Auth\Access\Response
      */
     public function inspect($ability, $arguments = [])
@@ -426,7 +429,7 @@ public function inspect($ability, $arguments = [])
      * Get the raw result from the authorization callback.
      *
      * @param  string  $ability
-     * @param  array|mixed  $arguments
+     * @param  array{class-string<TClass>|TClass, ...}  $arguments
      * @return mixed
      *
      * @throws \Illuminate\Auth\Access\AuthorizationException
