feature #19118 [HttpFoundation] Cookies Having Independent Partitioned State (CHIPS) (alexandre-daubois)

OskarStark · OskarStark · commit 419f5d7b8449 · 2023-11-07T16:55:22.000+01:00
This PR was merged into the 6.4 branch. Discussion ---------- [HttpFoundation] Cookies Having Independent Partitioned State (CHIPS) Fix #19027 Commits ------- 1673937 [HttpFoundation] Cookies Having Independent Partitioned State (CHIPS)
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
@@ -531,6 +531,21 @@ a new object with the modified property::
         ->withDomain('.example.com')
         ->withSecure(true);
 
+It is possible to define partitioned cookies, also known as `CHIPS`_, by using the
+:method:`Symfony\\Component\\HttpFoundation\\Cookie::withPartitioned` method::
+
+    $cookie = Cookie::create('foo')
+        ->withValue('bar')
+        ->withPartitioned();
+
+    // you can also set the partitioned argument to true when using the `create()` factory method
+    $cookie = Cookie::create('name', 'value', partitioned: true);
+
+.. versionadded:: 6.4
+
+    The :method:`Symfony\\Component\\HttpFoundation\\Cookie::withPartitioned`
+    method was introduced in Symfony 6.4.
+
 Managing the HTTP Cache
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -982,3 +997,4 @@ Learn More
 .. _OWASP guidelines: https://cheatsheetseries.owasp.org/cheatsheets/AJAX_Security_Cheat_Sheet.html#always-return-json-with-an-object-on-the-outside
 .. _RFC 8674: https://tools.ietf.org/html/rfc8674
 .. _Doctrine Batch processing: https://www.doctrine-project.org/projects/doctrine-orm/en/2.14/reference/batch-processing.html#iterating-results
+.. _`CHIPS`: https://developer.mozilla.org/en-US/docs/Web/Privacy/Partitioned_cookies
