Tweaks

Author: javiereguiluz

components/browser_kit.rst

@@ -288,17 +288,19 @@ into the client constructor::
     $client = new Client([], null, $cookieJar);
     // ...
 
+.. _component-browserkit-sending-cookies:
+
 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::
+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're also able to pass a string instead
+        // 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=/'
     ]);
 

http_client.rst

@@ -682,12 +682,9 @@ 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.
-
-However, you're able to send cookies in your request. This is how you can do
-so using :class:`Symfony\\Contracts\\HttpClient\\HttpClient`::
+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;
@@ -696,7 +693,7 @@ so using :class:`Symfony\\Contracts\\HttpClient\\HttpClient`::
         'headers' => [
             'Cookie' => new Cookie('flavor', 'chocolate', strtotime('+1 day')),
 
-            // you're also able to pass a string instead
+            // 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=/'
         ],
     ]);