[12.x] Improve docblocks for nullable parameters

src/Illuminate/Cache/RedisTagSet.php

@@ -13,7 +13,7 @@ class RedisTagSet extends TagSet
      *
      * @param  string  $key
      * @param  int|null  $ttl
-     * @param  string  $updateWhen
+     * @param  string|null  $updateWhen
      * @return void
      */
     public function addEntry(string $key, ?int $ttl = null, $updateWhen = null)

src/Illuminate/Contracts/Database/Eloquent/SupportsPartialRelations.php

@@ -9,7 +9,7 @@ interface SupportsPartialRelations
      *
      * @param  string|null  $column
      * @param  string|\Closure|null  $aggregate
-     * @param  string  $relation
+     * @param  string|null  $relation
      * @return $this
      */
     public function ofMany($column = 'id', $aggregate = 'MAX', $relation = null);

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

@@ -837,7 +837,7 @@ public function orWhereAttachedTo($related, $relationshipName = null)
      *
      * @param  mixed  $relations
      * @param  \Illuminate\Contracts\Database\Query\Expression|string  $column
-     * @param  string  $function
+     * @param  string|null  $function
      * @return $this
      */
     public function withAggregate($relations, $column, $function = null)

src/Illuminate/Database/Migrations/MigrationCreator.php

@@ -82,7 +82,7 @@ public function create($name, $path, $table = null, $create = false)
      * Ensure that a migration with the given name doesn't already exist.
      *
      * @param  string  $name
-     * @param  string  $migrationPath
+     * @param  string|null  $migrationPath
      * @return void
      *
      * @throws \InvalidArgumentException

src/Illuminate/Foundation/Configuration/Middleware.php

@@ -555,8 +555,8 @@ public function redirectUsersTo(callable|string $redirect)
     /**
      * Configure where users are redirected by the authentication and guest middleware.
      *
-     * @param  callable|string  $guests
-     * @param  callable|string  $users
+     * @param  callable|string|null  $guests
+     * @param  callable|string|null  $users
      * @return $this
      */
     public function redirectTo(callable|string|null $guests = null, callable|string|null $users = null)

src/Illuminate/Support/ServiceProvider.php

@@ -547,7 +547,7 @@ public static function defaultProviders()
      * Add the given provider to the application's provider bootstrap file.
      *
      * @param  string  $provider
-     * @param  string  $path
+     * @param  string|null  $path
      * @return bool
      */
     public static function addProviderToBootstrapFile(string $provider, ?string $path = null)

src/Illuminate/Support/Stringable.php

@@ -1045,7 +1045,7 @@ public function take(int $limit)
     /**
      * Trim the string of the given characters.
      *
-     * @param  string  $characters
+     * @param  string|null  $characters
      * @return static
      */
     public function trim($characters = null)
@@ -1056,7 +1056,7 @@ public function trim($characters = null)
     /**
      * Left trim the string of the given characters.
      *
-     * @param  string  $characters
+     * @param  string|null  $characters
      * @return static
      */
     public function ltrim($characters = null)
@@ -1067,7 +1067,7 @@ public function ltrim($characters = null)
     /**
      * Right trim the string of the given characters.
      *
-     * @param  string  $characters
+     * @param  string|null  $characters
      * @return static
      */
     public function rtrim($characters = null)