From e97513eebfa4715f1c096d00bce921d26ad22fd5 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Tue, 1 Sep 2026 10:13:15 +0200 Subject: [PATCH] [Sync-En] document the partitioned cookie attribute (PHP 8.5) --- reference/network/functions/setcookie.xml | 20 +++++-- reference/network/functions/setrawcookie.xml | 53 ++++++++++--------- .../functions/session-get-cookie-params.xml | 19 +++++-- .../functions/session-set-cookie-params.xml | 22 +++++--- reference/session/ini.xml | 30 ++++++++++- 5 files changed, 106 insertions(+), 38 deletions(-) diff --git a/reference/network/functions/setcookie.xml b/reference/network/functions/setcookie.xml index ae79aa85a7..a3aff28a21 100644 --- a/reference/network/functions/setcookie.xml +++ b/reference/network/functions/setcookie.xml @@ -1,6 +1,5 @@ - - + setcookie @@ -157,7 +156,7 @@ Un &array; asociativo que puede tener como claves expires, path, domain, - secure, httponly y samesite. + secure, httponly, partitioned y samesite. Los valores tienen el mismo significado que los descritos para los argumentos @@ -181,6 +180,13 @@ bloqueará la cookie. + + + Si partitioned es &true;, entonces + secure también debe estar habilitado; en caso + contrario se lanza un ValueError. + + @@ -228,6 +234,14 @@ + + 8.5.0 + + Se añadió la entrada "partitioned" al array options. + Si se establece a true, la cookie se marcará como + Partitioned (CHIPS). + + 8.2.0 diff --git a/reference/network/functions/setrawcookie.xml b/reference/network/functions/setrawcookie.xml index 2d3907893a..8f3de7c775 100644 --- a/reference/network/functions/setrawcookie.xml +++ b/reference/network/functions/setrawcookie.xml @@ -1,6 +1,5 @@ - - + setrawcookie @@ -50,28 +49,34 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 7.3.0 - - Se ha añadido una firma alternativa que soporta un array - de options. Esta firma permite - definir el atributo SameSite del cookie. - - - - - - + + + + + &Version; + &Description; + + + + + 8.5.0 + + Se añadió la entrada "partitioned" al array options. + Si se establece a true, la cookie se marcará como + Partitioned (CHIPS). + + + + 7.3.0 + + Se ha añadido una firma alternativa que soporta un array + de options. Esta firma permite + definir el atributo SameSite del cookie. + + + + + diff --git a/reference/session/functions/session-get-cookie-params.xml b/reference/session/functions/session-get-cookie-params.xml index 169dfcb01d..e796b2daf1 100644 --- a/reference/session/functions/session-get-cookie-params.xml +++ b/reference/session/functions/session-get-cookie-params.xml @@ -1,7 +1,5 @@ - - - + @@ -54,6 +52,12 @@ el cookie debe ser enviado solo en conexiones seguras. + + + "partitioned": + la cookie se marca como Partitioned (CHIPS). + + "httponly": @@ -82,6 +86,12 @@ + + 8.5.0 + + La entrada "partitioned" ha sido añadida en el array devuelto. + + 7.3.0 @@ -113,6 +123,9 @@ session.cookie_httponly + + session.cookie_partitioned + session.cookie_samesite diff --git a/reference/session/functions/session-set-cookie-params.xml b/reference/session/functions/session-set-cookie-params.xml index 9d1e8a6968..a4c78e287f 100644 --- a/reference/session/functions/session-set-cookie-params.xml +++ b/reference/session/functions/session-set-cookie-params.xml @@ -1,7 +1,5 @@ - - - + session_set_cookie_params @@ -47,11 +45,12 @@ Al utilizar la primera firma, la duración de vida de la cookie, en segundos. Ver la directiva lifetime. - + Al utilizar la segunda firma, un &array; asociativo que puede tener como claves lifetime, path, domain, - secure, httponly y samesite. + secure, httponly, partitioned + y samesite. Los valores tienen la misma significación que los descritos para los parámetros con el mismo nombre. El valor del elemento samesite debe ser Lax o Strict. @@ -59,7 +58,7 @@ idéntico al valor por defecto de los parámetros explícitos. Si el elemento samesite es omitido, entonces el atributo SameSite de la cookie no será definido. - + @@ -125,6 +124,14 @@ + + 8.5.0 + + Se añadió la entrada "partitioned" al array + lifetime_or_options. Si se establece a + true, la cookie se marcará como Partitioned (CHIPS). + + 8.0.0 @@ -171,6 +178,9 @@ session.cookie_httponly + + session.cookie_partitioned + session.cookie_samesite diff --git a/reference/session/ini.xml b/reference/session/ini.xml index e8c5d0b026..496b674e73 100644 --- a/reference/session/ini.xml +++ b/reference/session/ini.xml @@ -1,6 +1,5 @@ - - +
&reftitle.runtime; @@ -96,6 +95,12 @@ INI_ALL Anterior a PHP 7.2.0, el valor por omisión era "". + + session.cookie_partitioned + "0" + INI_ALL + Disponible a partir de PHP 8.5.0. + session.cookie_samesite "" @@ -686,6 +691,27 @@ + + + session.cookie_partitioned + bool + + + + Marca la cookie como particionada (CHIPS), lo que significa que la cookie + quedará aislada en un contexto de origen (first-party). Esta + configuración ayuda a mitigar el rastreo entre sitios (aunque no está + soportada por todos los navegadores). + + + Si se habilita, también debe habilitarse + session.cookie_secure; + en caso contrario la cookie de sesión no se enviará y se emitirá una + advertencia. + + + + session.cookie_samesite