ext/standard: Document partitioned option for setcookie/setrawcookie (8.5.0)

Author: lacatoire

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>

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>