[8.x] Add pipeThrough collection method (#40253)

* Add `pipeThrough` collection method

* Spacing

* Update EnumeratesValues.php

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

Author: stevebauman

src/Illuminate/Collections/Traits/EnumeratesValues.php

@@ -721,6 +721,22 @@ public function pipeInto($class)
         return new $class($this);
     }
 
+    /**
+     * Pass the collection through a series of callable pipes and return the result.
+     *
+     * @param  array<callable>  $pipes
+     * @return mixed
+     */
+    public function pipeThrough($pipes)
+    {
+        return static::make($pipes)->reduce(
+            function ($carry, $pipe) {
+                return $pipe($carry);
+            },
+            $this,
+        );
+    }
+
     /**
      * Pass the collection to the given callback and then return it.
      *

tests/Support/SupportCollectionTest.php

@@ -4007,6 +4007,25 @@ public function testPipeInto($collection)
         $this->assertSame($data, $instance->value);
     }
 
+    /**
+     * @dataProvider collectionClassProvider
+     */
+    public function testPipeThrough($collection)
+    {
+        $data = new $collection([1, 2, 3]);
+
+        $result = $data->pipeThrough([
+            function ($data) {
+                return $data->merge([4, 5]);
+            },
+            function ($data) {
+                return $data->sum();
+            },
+        ]);
+
+        $this->assertEquals(15, $result);
+    }
+
     /**
      * @dataProvider collectionClassProvider
      */