[HttpClient] add HttpClient::createForBaseUri()

Author: nicolas-grekas

CHANGELOG.md

@@ -4,10 +4,11 @@ CHANGELOG
 4.4.0
 -----
 
- * added `StreamWrapper`
+ * added `HttpClient::createForBaseUri()`
  * added `HttplugClient` with support for sync and async requests
  * added `max_duration` option
  * added support for NTLM authentication
+ * added `StreamWrapper` to cast any `ResponseInterface` instances to PHP streams.
  * added `$response->toStream()` to cast responses to regular PHP streams
  * made `Psr18Client` implement relevant PSR-17 factories and have streaming responses
  * added `TraceableHttpClient`, `HttpClientDataCollector` and `HttpClientPass` to integrate with the web profiler

HttpClient.php

@@ -39,4 +39,14 @@ public static function create(array $defaultOptions = [], int $maxHostConnection
 
         return new NativeHttpClient($defaultOptions, $maxHostConnections);
     }
+
+    /**
+     * Creates a client that adds options (e.g. authentication headers) only when the request URL matches the provided base URI.
+     */
+    public static function createForBaseUri(string $baseUri, array $defaultOptions = [], int $maxHostConnections = 6, int $maxPendingPushes = 50): HttpClientInterface
+    {
+        $client = self::create([], $maxHostConnections, $maxPendingPushes);
+
+        return ScopingHttpClient::forBaseUri($client, $baseUri, $defaultOptions);
+    }
 }