[12.x] Make Fluent class iterable (#56218)

* Allow iteration over Fluent

* Add test

* Update Fluent.php

---------

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

Author: 3 people

src/Illuminate/Support/Fluent.php

@@ -3,12 +3,15 @@
 namespace Illuminate\Support;
 
 use ArrayAccess;
+use ArrayIterator;
 use Illuminate\Contracts\Support\Arrayable;
 use Illuminate\Contracts\Support\Jsonable;
 use Illuminate\Support\Traits\Conditionable;
 use Illuminate\Support\Traits\InteractsWithData;
 use Illuminate\Support\Traits\Macroable;
+use IteratorAggregate;
 use JsonSerializable;
+use Traversable;
 
 /**
  * @template TKey of array-key
@@ -17,7 +20,7 @@
  * @implements \Illuminate\Contracts\Support\Arrayable<TKey, TValue>
  * @implements \ArrayAccess<TKey, TValue>
  */
-class Fluent implements Arrayable, ArrayAccess, Jsonable, JsonSerializable
+class Fluent implements Arrayable, ArrayAccess, IteratorAggregate, Jsonable, JsonSerializable
 {
     use Conditionable, InteractsWithData, Macroable {
         __call as macroCall;
@@ -245,6 +248,16 @@ public function offsetUnset($offset): void
         unset($this->attributes[$offset]);
     }
 
+    /**
+     * Get an iterator for the attributes.
+     *
+     * @return ArrayIterator<TKey, TValue>
+     */
+    public function getIterator(): Traversable
+    {
+        return new ArrayIterator($this->attributes);
+    }
+
     /**
      * Handle dynamic calls to the fluent instance to set attributes.
      *

tests/Support/SupportFluentTest.php

@@ -452,6 +452,25 @@ public function testMacroable()
             'baz' => 'zal',
         ], $fluent->foo()->all());
     }
+
+    public function testFluentIsIterable()
+    {
+        $fluent = new Fluent([
+            'name' => 'Taylor',
+            'role' => 'admin',
+        ]);
+
+        $result = [];
+
+        foreach ($fluent as $key => $value) {
+            $result[$key] = $value;
+        }
+
+        $this->assertSame([
+            'name' => 'Taylor',
+            'role' => 'admin',
+        ], $result);
+    }
 }
 
 class FluentArrayIteratorStub implements IteratorAggregate