Add on request callback hook to the http client

Author: timacdonald

src/Illuminate/Http/Client/Factory.php

@@ -28,6 +28,13 @@ class Factory
      */
     protected $dispatcher;
 
+    /**
+     * The callbacks that should execute before every request is sent.
+     *
+     * @var array
+     */
+    protected $beforeSendingCallbacks = [];
+
     /**
      * The stub callables that will handle requests.
      *
@@ -76,6 +83,19 @@ public function __construct(Dispatcher $dispatcher = null)
         $this->stubCallbacks = collect();
     }
 
+    /**
+     * Add a new "before sending" callback to every request.
+     *
+     * @param  callable  $callback
+     * @return $this
+     */
+    public function beforeSending($callback)
+    {
+        $this->beforeSendingCallbacks[] = $callback;
+
+        return $this;
+    }
+
     /**
      * Create a new response instance for use during stubbing.
      *
@@ -353,7 +373,11 @@ public function recorded($callback = null)
      */
     protected function newPendingRequest()
     {
-        return new PendingRequest($this);
+        return tap(new PendingRequest($this), function ($request) {
+            foreach ($this->beforeSendingCallbacks as $callback) {
+                $request->beforeSending($callback);
+            }
+        });
     }
 
     /**

tests/Http/HttpClientTest.php

@@ -2316,4 +2316,23 @@ public function testTheTransferStatsAreCustomizableOnFake(): void
 
         $this->assertTrue($onStatsFunctionCalled);
     }
+
+    public function testItCanMakeGlobalChangesToNewPendingRequests()
+    {
+        $request = null;
+        $this->factory->beforeSending(function (Request $request, array $options, PendingRequest $pending) {
+            return $request->toPsrRequest()->withHeader('User-Agent', 'Laravel Framework/1.0');
+        });
+        $this->factory->fake(function ($r) use (&$request) {
+            $request = $r;
+
+            return $this->factory::response('expected content');
+        });
+
+        $response = $this->factory->post('http://vapor.laravel.com');
+
+        $this->assertSame('expected content', $response->body());
+        $this->assertNotNull($request);
+        $this->assertSame(['Laravel Framework/1.0'], $request->header('User-Agent'));
+    }
 }