Merge branch '5.4' into 6.2

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

Author: javiereguiluz

components/browser_kit.rst

@@ -273,6 +273,27 @@ into the client constructor::
     $client = new Client([], null, $cookieJar);
     // ...
 
+.. _component-browserkit-sending-cookies:
+
+Sending Cookies
+~~~~~~~~~~~~~~~
+
+Requests can include cookies. To do so, use the ``serverParameters`` argument of
+the :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::request` method
+to set the ``Cookie`` header value::
+
+    $client->request('GET', '/', [], [], [
+        'HTTP_COOKIE' => new Cookie('flavor', 'chocolate', strtotime('+1 day')),
+
+        // you can also pass the cookie contents as a string
+        'HTTP_COOKIE' => 'flavor=chocolate; expires=Sat, 11 Feb 2023 12:18:13 GMT; Max-Age=86400; path=/'
+    ]);
+
+.. note::
+
+    All HTTP headers set with the ``serverParameters`` argument must be
+    prefixed by ``HTTP_``.
+
 History
 -------
 

http_client.rst

@@ -674,9 +674,21 @@ requires a stateful storage (because responses can update cookies and they must
 be used for subsequent requests). That's why this component doesn't handle
 cookies automatically.
 
-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.
+You can either :ref:`send cookies with the BrowserKit component <component-browserkit-sending-cookies>`,
+which integrates seamlessly with the HttpClient component, or manually setting
+the ``Cookie`` HTTP header as follows::
+
+    use Symfony\Component\HttpClient\HttpClient;
+    use Symfony\Component\HttpFoundation\Cookie;
+
+    $client = HttpClient::create([
+        'headers' => [
+            'Cookie' => new Cookie('flavor', 'chocolate', strtotime('+1 day')),
+
+            // you can also pass the cookie contents as a string
+            'Cookie' => 'flavor=chocolate; expires=Sat, 11 Feb 2023 12:18:13 GMT; Max-Age=86400; path=/'
+        ],
+    ]);
 
 Redirects
 ~~~~~~~~~