[12.x] Add collection() to Config repository (laravel#56200)

* [12.x] Add `collection()` to Config repository

* Update Repository.php

---------

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

Author: 2 people

src/Illuminate/Config/Repository.php

@@ -5,6 +5,7 @@
 use ArrayAccess;
 use Illuminate\Contracts\Config\Repository as ConfigContract;
 use Illuminate\Support\Arr;
+use Illuminate\Support\Collection;
 use Illuminate\Support\Traits\Macroable;
 use InvalidArgumentException;
 
@@ -177,6 +178,18 @@ public function array(string $key, $default = null): array
         return $value;
     }
 
+    /**
+     * Get the specified array configuration value as a collection.
+     *
+     * @param  string  $key
+     * @param  (\Closure():(array<array-key, mixed>|null))|array<array-key, mixed>|null  $default
+     * @return Collection<array-key, mixed>
+     */
+    public function collection(string $key, $default = null): Collection
+    {
+        return new Collection($this->array($key, $default));
+    }
+
     /**
      * Set a given configuration value.
      *

src/Illuminate/Support/Facades/Config.php

@@ -11,6 +11,7 @@
  * @method static float float(string $key, \Closure|float|null $default = null)
  * @method static bool boolean(string $key, \Closure|bool|null $default = null)
  * @method static array array(string $key, \Closure|array|null $default = null)
+ * @method static \Illuminate\Support\Collection collection(string $key, \Closure|array|null $default = null)
  * @method static void set(array|string $key, mixed $value = null)
  * @method static void prepend(string $key, mixed $value)
  * @method static void push(string $key, mixed $value)

tests/Config/RepositoryTest.php

@@ -3,6 +3,7 @@
 namespace Illuminate\Tests\Config;
 
 use Illuminate\Config\Repository;
+use Illuminate\Support\Collection;
 use InvalidArgumentException;
 use PHPUnit\Framework\TestCase;
 
@@ -319,6 +320,14 @@ public function testItThrowsAnExceptionWhenTryingToGetNonArrayValueAsArray(): vo
         $this->repository->array('a.b');
     }
 
+    public function testItGetsAsCollection(): void
+    {
+        $collection = $this->repository->collection('array');
+
+        $this->assertInstanceOf(Collection::class, $collection);
+        $this->assertSame(['aaa', 'zzz'], $collection->toArray());
+    }
+
     public function testItGetsAsBoolean(): void
     {
         $this->assertTrue(