From f677f12fd1e378a070516000c655776c1cdec2e0 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud <la.catoire@gmail.com>
Date: Fri, 10 Jul 2026 14:50:42 +0200
Subject: [PATCH] ext/standard: Document partitioned option for
 setcookie/setrawcookie (8.5.0)

---
 reference/network/functions/setcookie.xml    | 20 +++++++++++++++++++-
 reference/network/functions/setrawcookie.xml |  7 +++++++
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/reference/network/functions/setcookie.xml b/reference/network/functions/setcookie.xml
index 89d0f86a0c85..bf5c907fbe76 100644
--- a/reference/network/functions/setcookie.xml
+++ b/reference/network/functions/setcookie.xml
@@ -157,7 +157,9 @@
       <simpara>
        An associative <type>array</type> which may have any of the keys
        <literal>expires</literal>, <literal>path</literal>, <literal>domain</literal>,
-       <literal>secure</literal>, <literal>httponly</literal> and <literal>samesite</literal>.
+       <literal>secure</literal>, <literal>httponly</literal>,
+       <literal>samesite</literal> and, as of PHP 8.5.0,
+       <literal>partitioned</literal>.
       </simpara>
       <simpara>
        The values have the same meaning as described for the
@@ -183,6 +185,15 @@
         blocked by the client.
        </simpara>
       </note>
+      <note>
+       <simpara>
+        As of PHP 8.5.0, the <literal>partitioned</literal> option marks the
+        cookie for partitioned storage using an independent partition per
+        top-level site (CHIPS). It must be used together with
+        <literal>secure</literal>; otherwise a
+        <exceptionname>ValueError</exceptionname> is thrown.
+       </simpara>
+      </note>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -229,6 +240,13 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       The <parameter>options</parameter> array now supports the
+       <literal>partitioned</literal> key.
+      </entry>
+     </row>
      <row>
       <entry>8.2.0</entry>
       <entry>
diff --git a/reference/network/functions/setrawcookie.xml b/reference/network/functions/setrawcookie.xml
index 992c73278aa3..4b1f8a568905 100644
--- a/reference/network/functions/setrawcookie.xml
+++ b/reference/network/functions/setrawcookie.xml
@@ -59,6 +59,13 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.5.0</entry>
+       <entry>
+        The <parameter>options</parameter> array now supports the
+        <literal>partitioned</literal> key.
+       </entry>
+      </row>
       <row>
        <entry>7.3.0</entry>
        <entry>