Improve docblocks for nullable parameters (#56996)

Author: amirhshokri

src/Illuminate/Collections/LazyCollection.php

@@ -1344,7 +1344,7 @@ public function split($numberOfGroups)
     /**
      * Get the first item in the collection, but only if exactly one item exists. Otherwise, throw an exception.
      *
-     * @param  (callable(TValue, TKey): bool)|string  $key
+     * @param  (callable(TValue, TKey): bool)|string|null  $key
      * @param  mixed  $operator
      * @param  mixed  $value
      * @return TValue
@@ -1369,7 +1369,7 @@ public function sole($key = null, $operator = null, $value = null)
     /**
      * Get the first item in the collection but throw an exception if no matching items exist.
      *
-     * @param  (callable(TValue, TKey): bool)|string  $key
+     * @param  (callable(TValue, TKey): bool)|string|null  $key
      * @param  mixed  $operator
      * @param  mixed  $value
      * @return TValue

src/Illuminate/Database/Eloquent/Relations/HasOneOrManyThrough.php

@@ -468,7 +468,7 @@ public function get($columns = ['*'])
      * @param  int|null  $perPage
      * @param  array  $columns
      * @param  string  $pageName
-     * @param  int  $page
+     * @param  int|null  $page
      * @return \Illuminate\Pagination\LengthAwarePaginator
      */
     public function paginate($perPage = null, $columns = ['*'], $pageName = 'page', $page = null)

src/Illuminate/Database/Schema/ForeignIdColumnDefinition.php

@@ -46,7 +46,7 @@ public function constrained($table = null, $column = null, $indexName = null)
      * Specify which column this foreign ID references on another table.
      *
      * @param  string  $column
-     * @param  string  $indexName
+     * @param  string|null  $indexName
      * @return \Illuminate\Database\Schema\ForeignKeyDefinition
      */
     public function references($column, $indexName = null)

src/Illuminate/Foundation/Testing/Concerns/InteractsWithDatabase.php

@@ -285,7 +285,7 @@ public function castAsJson($value, $connection = null)
      * Get the database connection.
      *
      * @param  string|null  $connection
-     * @param  \Illuminate\Database\Eloquent\Model|class-string<\Illuminate\Database\Eloquent\Model>|string  $table
+     * @param  \Illuminate\Database\Eloquent\Model|class-string<\Illuminate\Database\Eloquent\Model>|string|null  $table
      * @return \Illuminate\Database\Connection
      */
     protected function getConnection($connection = null, $table = null)

src/Illuminate/Http/Concerns/InteractsWithInput.php

@@ -250,7 +250,7 @@ public function file($key = null, $default = null)
     /**
      * Retrieve data from the instance.
      *
-     * @param  string  $key
+     * @param  string|null  $key
      * @param  mixed  $default
      * @return mixed
      */

src/Illuminate/Http/Exceptions/HttpResponseException.php

@@ -19,7 +19,7 @@ class HttpResponseException extends RuntimeException
      * Create a new HTTP response exception instance.
      *
      * @param  \Symfony\Component\HttpFoundation\Response  $response
-     * @param  \Throwable  $previous
+     * @param  \Throwable|null  $previous
      */
     public function __construct(Response $response, ?Throwable $previous = null)
     {

src/Illuminate/Queue/InteractsWithQueue.php

@@ -211,7 +211,7 @@ public function assertNotFailed()
     /**
      * Assert that the job was released back onto the queue.
      *
-     * @param  \DateTimeInterface|\DateInterval|int  $delay
+     * @param  \DateTimeInterface|\DateInterval|int|null  $delay
      * @return $this
      */
     public function assertReleased($delay = null)

src/Illuminate/Support/Facades/Http.php

@@ -117,7 +117,7 @@ protected static function getFacadeAccessor()
     /**
      * Register a stub callable that will intercept requests and be able to return stub responses.
      *
-     * @param  \Closure|array  $callback
+     * @param  \Closure|array|null  $callback
      * @return \Illuminate\Http\Client\Factory
      */
     public static function fake($callback = null)

src/Illuminate/Support/Fluent.php

@@ -153,7 +153,7 @@ public function all($keys = null)
     /**
      * Get data from the fluent instance.
      *
-     * @param  string  $key
+     * @param  string|null  $key
      * @param  mixed  $default
      * @return mixed
      */

src/Illuminate/Support/InteractsWithTime.php

@@ -67,7 +67,7 @@ protected function currentTime()
      * Given a start time, format the total run time for human readability.
      *
      * @param  float  $startTime
-     * @param  float  $endTime
+     * @param  float|null  $endTime
      * @return string
      */
     protected function runTimeForHumans($startTime, $endTime = null)