[11.x] Add resource() method to Illuminate\Http\Client\Response (#52412)

* Add resource method to Illuminate\Http\Client\Response

* Update Response.php

---------

Co-authored-by: Taylor Otwell <taylor@laravel.com>

Author: einar-hansen

src/Illuminate/Http/Client/Response.php

@@ -3,6 +3,7 @@
 namespace Illuminate\Http\Client;
 
 use ArrayAccess;
+use GuzzleHttp\Psr7\StreamWrapper;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Traits\Macroable;
 use LogicException;
@@ -104,6 +105,18 @@ public function collect($key = null)
         return Collection::make($this->json($key));
     }
 
+    /**
+     * Get the body of the response as a PHP resource.
+     *
+     * @return resource
+     *
+     * @throws \InvalidArgumentException
+     */
+    public function resource()
+    {
+        return StreamWrapper::getResource($this->response->getBody());
+    }
+
     /**
      * Get a header from the response.
      *

tests/Http/HttpClientTest.php

@@ -327,6 +327,18 @@ public function testResponseObjectAsObject()
         $this->assertSame('bar', $response->object()->result->foo);
     }
 
+    public function testResponseCanBeReturnedAsResource()
+    {
+        $this->factory->fake([
+            '*' => ['result' => ['foo' => 'bar']],
+        ]);
+
+        $response = $this->factory->get('http://foo.com/api');
+
+        $this->assertIsResource($response->resource());
+        $this->assertSame('{"result":{"foo":"bar"}}', stream_get_contents($response->resource()));
+    }
+
     public function testResponseCanBeReturnedAsCollection()
     {
         $this->factory->fake([