[11.x] Introduce method Http::createPendingRequest() (#50980)

* Introduce method `\Illuminate\Http\Client\Factory::createPendingRequest()`

* Fix passing stubs & stray requests

* Update comments

src/Illuminate/Http/Client/Factory.php

@@ -418,6 +418,18 @@ public function recorded($callback = null)
      *
      * @return \Illuminate\Http\Client\PendingRequest
      */
+    public function createPendingRequest()
+    {
+        return tap($this->newPendingRequest(), function ($request) {
+            $request->stub($this->stubCallbacks)->preventStrayRequests($this->preventStrayRequests);
+        });
+    }
+
+    /**
+     * Instantiate a new pending request instance for this factory.
+     *
+     * @return \Illuminate\Http\Client\PendingRequest
+     */
     protected function newPendingRequest()
     {
         return (new PendingRequest($this, $this->globalMiddleware))->withOptions(value($this->globalOptions));
@@ -456,8 +468,6 @@ public function __call($method, $parameters)
             return $this->macroCall($method, $parameters);
         }
 
-        return tap($this->newPendingRequest(), function ($request) {
-            $request->stub($this->stubCallbacks)->preventStrayRequests($this->preventStrayRequests);
-        })->{$method}(...$parameters);
+        return $this->createPendingRequest()->{$method}(...$parameters);
     }
 }

tests/Http/HttpClientTest.php

@@ -3025,6 +3025,13 @@ public function testItCanHaveGlobalDefaultValues()
         $this->assertSame(['false'], $headers['X-Foo']);
         $this->assertSame(['true'], $headers['X-Bar']);
     }
+
+    public function testItCanCreatePendingRequest()
+    {
+        $factory = new Factory();
+
+        $this->assertInstanceOf(PendingRequest::class, $factory->createPendingRequest());
+    }
 }
 
 class CustomFactory extends Factory