[12.x] Add unified enum support across framework docs (#56271)

* add enum support for storage

* add enum support for DB

* add enum support for redis

* add enum support for helpers

* add enum support for scheduler

* add enum support for broadcast

* fix docblock order

* add enum support for scheduler timezone() method

* add enum support for request date() method

* fix docblock order

* fix style ci

Author: amirhshokri

src/Illuminate/Broadcasting/InteractsWithBroadcasting.php

@@ -4,6 +4,8 @@
 
 use Illuminate\Support\Arr;
 
+use function Illuminate\Support\enum_value;
+
 trait InteractsWithBroadcasting
 {
     /**
@@ -16,11 +18,13 @@ trait InteractsWithBroadcasting
     /**
      * Broadcast the event using a specific broadcaster.
      *
-     * @param  array|string|null  $connection
+     * @param  \UnitEnum|array|string|null  $connection
      * @return $this
      */
     public function broadcastVia($connection = null)
     {
+        $connection = enum_value($connection);
+
         $this->broadcastConnection = is_null($connection)
             ? [null]
             : Arr::wrap($connection);

src/Illuminate/Broadcasting/PendingBroadcast.php

@@ -4,6 +4,8 @@
 
 use Illuminate\Contracts\Events\Dispatcher;
 
+use function Illuminate\Support\enum_value;
+
 class PendingBroadcast
 {
     /**
@@ -35,13 +37,13 @@ public function __construct(Dispatcher $events, $event)
     /**
      * Broadcast the event using a specific broadcaster.
      *
-     * @param  string|null  $connection
+     * @param  \UnitEnum|string|null  $connection
      * @return $this
      */
     public function via($connection = null)
     {
         if (method_exists($this->event, 'broadcastVia')) {
-            $this->event->broadcastVia($connection);
+            $this->event->broadcastVia(enum_value($connection));
         }
 
         return $this;

src/Illuminate/Console/Scheduling/ManagesFrequencies.php

@@ -5,6 +5,8 @@
 use Illuminate\Support\Carbon;
 use InvalidArgumentException;
 
+use function Illuminate\Support\enum_value;
+
 trait ManagesFrequencies
 {
     /**
@@ -639,12 +641,12 @@ public function days($days)
     /**
      * Set the timezone the date should be evaluated on.
      *
-     * @param  \DateTimeZone|string  $timezone
+     * @param  \UnitEnum|\DateTimeZone|string  $timezone
      * @return $this
      */
     public function timezone($timezone)
     {
-        $this->timezone = $timezone;
+        $this->timezone = enum_value($timezone);
 
         return $this;
     }

src/Illuminate/Console/Scheduling/Schedule.php

@@ -19,6 +19,8 @@
 use Illuminate\Support\Traits\Macroable;
 use RuntimeException;
 
+use function Illuminate\Support\enum_value;
+
 /**
  * @mixin \Illuminate\Console\Scheduling\PendingEventAttributes
  */
@@ -170,14 +172,17 @@ public function command($command, array $parameters = [])
      * Add a new job callback event to the schedule.
      *
      * @param  object|string  $job
-     * @param  string|null  $queue
-     * @param  string|null  $connection
+     * @param  \UnitEnum|string|null  $queue
+     * @param  \UnitEnum|string|null  $connection
      * @return \Illuminate\Console\Scheduling\CallbackEvent
      */
     public function job($job, $queue = null, $connection = null)
     {
         $jobName = $job;
 
+        $queue = enum_value($queue);
+        $connection = enum_value($connection);
+
         if (! is_string($job)) {
             $jobName = method_exists($job, 'displayName')
                 ? $job->displayName()

src/Illuminate/Contracts/Filesystem/Factory.php

@@ -7,7 +7,7 @@ interface Factory
     /**
      * Get a filesystem implementation.
      *
-     * @param  string|null  $name
+     * @param  \UnitEnum|string|null  $name
      * @return \Illuminate\Contracts\Filesystem\Filesystem
      */
     public function disk($name = null);

src/Illuminate/Contracts/Redis/Factory.php

@@ -7,7 +7,7 @@ interface Factory
     /**
      * Get a Redis connection by name.
      *
-     * @param  string|null  $name
+     * @param  \UnitEnum|string|null  $name
      * @return \Illuminate\Redis\Connections\Connection
      */
     public function connection($name = null);

src/Illuminate/Database/Connection.php

@@ -25,6 +25,8 @@
 use PDOStatement;
 use RuntimeException;
 
+use function Illuminate\Support\enum_value;
+
 class Connection implements ConnectionInterface
 {
     use DetectsConcurrencyErrors,
@@ -307,13 +309,13 @@ public function getSchemaBuilder()
     /**
      * Begin a fluent query against a database table.
      *
-     * @param  \Closure|\Illuminate\Database\Query\Builder|\Illuminate\Contracts\Database\Query\Expression|string  $table
+     * @param  \Closure|\Illuminate\Database\Query\Builder|\Illuminate\Contracts\Database\Query\Expression|\UnitEnum|string  $table
      * @param  string|null  $as
      * @return \Illuminate\Database\Query\Builder
      */
     public function table($table, $as = null)
     {
-        return $this->query()->from($table, $as);
+        return $this->query()->from(enum_value($table), $as);
     }
 
     /**

src/Illuminate/Database/ConnectionInterface.php

@@ -9,7 +9,7 @@ interface ConnectionInterface
     /**
      * Begin a fluent query against a database table.
      *
-     * @param  \Closure|\Illuminate\Database\Query\Builder|string  $table
+     * @param  \Closure|\Illuminate\Database\Query\Builder|\UnitEnum|string  $table
      * @param  string|null  $as
      * @return \Illuminate\Database\Query\Builder
      */

src/Illuminate/Database/ConnectionResolverInterface.php

@@ -7,7 +7,7 @@ interface ConnectionResolverInterface
     /**
      * Get a database connection instance.
      *
-     * @param  string|null  $name
+     * @param  \UnitEnum|string|null  $name
      * @return \Illuminate\Database\ConnectionInterface
      */
     public function connection($name = null);

src/Illuminate/Database/DatabaseManager.php

@@ -13,6 +13,8 @@
 use PDO;
 use RuntimeException;
 
+use function Illuminate\Support\enum_value;
+
 /**
  * @mixin \Illuminate\Database\Connection
  */
@@ -85,12 +87,12 @@ public function __construct($app, ConnectionFactory $factory)
     /**
      * Get a database connection instance.
      *
-     * @param  string|null  $name
+     * @param  \UnitEnum|string|null  $name
      * @return \Illuminate\Database\Connection
      */
     public function connection($name = null)
     {
-        $name = $name ?: $this->getDefaultConnection();
+        $name = enum_value($name) ?: $this->getDefaultConnection();
 
         [$database, $type] = $this->parseConnectionName($name);