Request URI Manipulations

Author: soullivaneuh

plugins/index.rst

@@ -20,5 +20,6 @@ request or you can even start a completely new request. This gives you full cont
    history
    logger
    redirect
+   request-uri-manipulations
    retry
    stopwatch

plugins/request-uri-manipulations.rst

@@ -0,0 +1,25 @@
+Request URI Manipulations
+=========================
+
+Request URI manipulations can be done thanks to several plugins:
+
+* ``AddHostPlugin``: Sets default host, scheme and port of each request.
+* ``AddPathPlugin``: Sets default base path of each request.
+* ``BaseUriPlugin``: Is a combination of ``AddHostPlugin`` and ``AddPathPlugin`` using the ``UriInterface`` class.
+
+Each plugin use the ``UriInterface`` to build the base request::
+
+    use Http\Discovery\HttpClientDiscovery;
+    use Http\Discovery\UriFactoryDiscovery;
+    use Http\Client\Common\PluginClient;
+    use Http\Client\Common\Plugin\BaseUriPlugin;
+
+    $plugin = new BaseUriPlugin(UriFactoryDiscovery::find()->createUri('https://domain.com:8000/api'), [
+        // Always replace the host, even if this one is provided on the sent request. Available for AddHostPlugin.
+        'replace' => 'true',
+    ]));
+
+    $pluginClient = new PluginClient(
+        HttpClientDiscovery::find(),
+        [$plugin]
+    );