[HttpClient][BrowserKit] Add examples to set cookies in the request

Author: alexandre-daubois

components/browser_kit.rst

@@ -288,6 +288,28 @@ into the client constructor::
     $client = new Client([], null, $cookieJar);
     // ...
 
+Sending Cookies
+~~~~~~~~~~~~~~~
+
+By setting the ``Cookie`` header value, you are able to send cookies with your
+request thanks to the ``serverParameters`` argument of the
+:method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::request` method::
+
+    $client->request('GET', '/', [], [], [
+        'HTTP_COOKIE' => new Cookie('flavor', 'chocolate', strtotime('+1 day')),
+    ]);
+
+.. note::
+
+    :class:`Symfony\\Component\\HttpFoundation\\Cookie` is a helper class to
+    help you create cookies. You're also able to pass a simple string as the
+    value of the ``Cookie`` header.
+
+.. note::
+
+    All HTTP headers set with the ``serverParameters`` argument must be
+    prefixed by ``HTTP_``.
+
 History
 -------
 

http_client.rst

@@ -686,6 +686,24 @@ You can either handle cookies yourself using the ``Cookie`` HTTP header or use
 the :doc:`BrowserKit component </components/browser_kit>` which provides this
 feature and integrates seamlessly with the HttpClient component.
 
+However, you're able to send cookies in your request. This is how you can do
+so using :class:`Symfony\\Contracts\\HttpClient\\HttpClient`::
+
+    use Symfony\Component\HttpClient\HttpClient;
+    use Symfony\Component\HttpFoundation\Cookie;
+
+    $client = HttpClient::create([
+        'headers' => [
+            'Cookie' => new Cookie('flavor', 'chocolate', strtotime('+1 day')),
+        ],
+    ]);
+
+.. note::
+
+    The :class:`Symfony\\Component\\HttpFoundation\\Cookie` class is a helper to
+    help you create cookies. You're also able to pass a simple string as the
+    value of the ``Cookie`` header.
+
 Redirects
 ~~~~~~~~~