Create HTTP Pool finally hook

src/Illuminate/Http/Client/PendingRequest.php

@@ -895,6 +895,7 @@ public function pool(callable $callback)
         $progressCallback = $pool->progressCallback();
         $catchCallback = $pool->catchCallback();
         $thenCallback = $pool->thenCallback();
+        $finallyCallback = $pool->finallyCallback();
         $success = 0;
 
         foreach ($requests as $key => $item) {
@@ -920,6 +921,10 @@ public function pool(callable $callback)
             $thenCallback($results);
         }
 
+        if ($finallyCallback !== null) {
+            $finallyCallback($results);
+        }
+
         return $results;
     }
 

src/Illuminate/Http/Client/Pool.php

@@ -52,6 +52,13 @@ class Pool
      */
     protected $thenCallback = null;
 
+    /**
+     * The callback to run after all the requests from the pool finish.
+     *
+     * @var \Closure|null
+     */
+    protected $finallyCallback = null;
+
     /**
      * Create a new requests pool.
      *
@@ -168,4 +175,25 @@ public function thenCallback(): ?Closure
     {
         return $this->thenCallback;
     }
+
+    /**
+     * Register a callback to run after all the requests from the pool finish.
+     *
+     * @param  Closure  $callback
+     * @return void
+     */
+    public function finally(Closure $callback)
+    {
+        $this->finallyCallback = $callback;
+    }
+
+    /**
+     * Retrieve the finally callback in the pool.
+     *
+     * @return \Closure|null
+     */
+    public function finallyCallback(): ?Closure
+    {
+        return $this->finallyCallback;
+    }
 }

tests/Http/HttpClientTest.php

@@ -3915,6 +3915,68 @@ public function testPoolThenHookIsNotCalled(): void
         $this->assertCount(0, $thenCallback);
     }
 
+    public function testPoolFinallyHookIsCalledWithoutErrors(): void
+    {
+        $this->factory->fake([
+            'https://200.com' => $this->factory::response('OK', 200),
+            'https://201.com' => $this->factory::response('Created', 201),
+        ]);
+
+        $finallyCallback = [];
+
+        $responses = $this->factory->pool(function (Pool $pool) use (&$finallyCallback) {
+            $pool->finally(function (array $results) use (&$finallyCallback) {
+                $finallyCallback = $results;
+            });
+
+            return [
+                $pool->as('first')->get('https://200.com'),
+                $pool->as('second')->get('https://201.com'),
+            ];
+        });
+
+        $this->assertSame(200, $responses['first']->status());
+        $this->assertSame(201, $responses['second']->status());
+
+        $this->assertCount(2, $finallyCallback);
+        $this->assertArrayHasKey('first', $finallyCallback);
+        $this->assertArrayHasKey('second', $finallyCallback);
+
+        $this->assertSame($responses['first'], $finallyCallback['first']);
+        $this->assertSame($responses['second'], $finallyCallback['second']);
+    }
+
+    public function testPoolFinallyHookIsCalledWithErrors(): void
+    {
+        $this->factory->fake([
+            'https://200.com' => $this->factory::response('OK', 200),
+            'https://500.com' => $this->factory::response('Error', 500),
+        ]);
+
+        $finallyCallback = [];
+
+        $responses = $this->factory->pool(function (Pool $pool) use (&$finallyCallback) {
+            $pool->finally(function (array $results) use (&$finallyCallback) {
+                $finallyCallback = $results;
+            });
+
+            return [
+                $pool->as('first')->get('https://200.com'),
+                $pool->as('second')->get('https://500.com'),
+            ];
+        });
+
+        $this->assertSame(200, $responses['first']->status());
+        $this->assertSame(500, $responses['second']->status());
+
+        $this->assertCount(2, $finallyCallback);
+        $this->assertArrayHasKey('first', $finallyCallback);
+        $this->assertArrayHasKey('second', $finallyCallback);
+
+        $this->assertSame($responses['first'], $finallyCallback['first']);
+        $this->assertSame($responses['second'], $finallyCallback['second']);
+    }
+
     public static function methodsReceivingArrayableDataProvider()
     {
         return [