Add withQueryParameters to the HTTP client

Some APIs require some query parameters to be always set. For example auth token (even though this isn't a great practice).

With this new helper, we can create a macro with the query parameter always set.

src/Illuminate/Http/Client/PendingRequest.php

@@ -477,6 +477,21 @@ public function withCookies(array $cookies, string $domain)
         });
     }
 
+    /**
+     * Set the given query parameters in the request URI.
+     *
+     * @param  array  $parameters
+     * @return $this
+     */
+    public function withQueryParameters(array $parameters)
+    {
+        return tap($this, function () use ($parameters) {
+            $this->options = array_merge_recursive($this->options, [
+                'query' => $parameters,
+            ]);
+        });
+    }
+
     /**
      * Specify the maximum number of redirects to allow.
      *

tests/Http/HttpClientTest.php

@@ -722,6 +722,19 @@ public function testWithCookies()
         $this->assertSame('https://laravel.com', $responseCookie['Domain']);
     }
 
+    public function testWithQueryParameters()
+    {
+        $this->factory->fake();
+
+        $this->factory->withQueryParameters(
+            ['foo' => 'bar']
+        )->get('https://laravel.com');
+
+        $this->factory->assertSent(function (Request $request) {
+            return $request->url() === 'https://laravel.com?foo=bar';
+        });
+    }
+
     public function testGetWithArrayQueryParam()
     {
         $this->factory->fake();