network section sync (#762)

php · Jan 22, 2024 · 5ad0db3 · 5ad0db3
1 parent 74db1fe
commit 5ad0db3
Show file tree

Hide file tree

Showing 2 changed files with 32 additions and 3 deletions.
diff --git a/reference/network/functions/header.xml b/reference/network/functions/header.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 6b053588fb22cdc167766d4aa0e2f87cd52ecb32 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 5c1ccc6e24e5d470e75ef0a5887c2ff583266375 Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.header">
@@ -230,6 +230,27 @@ header("Expires: Sat, 26 Jul 1997 05:00:00 GMT"); // Date dans le passé
     </para>
    </example>
   </para>
+  <para>
+   <example>
+    <title>Paramétrer un cookie</title>
+    <para>
+     <function>setcookie</function> offre un moyen pratique de paramétrer des cookies.
+     Pour définir un cookie avec des attributs non pris en charge par <function>setcookie</function>,
+     <function>header</function> peut être utilisé.
+    </para>
+    <para>
+     Par exemple, le code suivant définit un cookie qui inclut un attribut
+     <literal>Partitioned</literal>.
+    </para>
+    <programlisting role="php">
+<![CDATA[
+<?php
+header('Set-Cookie: name=value; Secure; Path=/; SameSite=None; Partitioned;');
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
  </refsect1>
 
  <refsect1 role="notes">

diff --git a/reference/network/functions/setcookie.xml b/reference/network/functions/setcookie.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5d6153f896f4698bc2df1a41db1271075dd3b62d Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 5c1ccc6e24e5d470e75ef0a5887c2ff583266375 Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.setcookie" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -170,6 +170,14 @@
        <literal>samesite</literal> est omit, alors l'attribut SameSite du cookie 
        ne sera pas définie.
       </para>
+      <para>
+       <note>
+        <para>
+         Pour définir un cookie qui inclut des attributs qui ne figurent pas parmi les clés répertoriées,
+         utilisez <function>header</function>.
+        </para>
+       </note>
+      </para>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -223,7 +231,7 @@
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
-   Quelques exemples d'envoi de cookies :
+   Les exemples suivants démontrent quelques façons d'envoyer des cookies.
    <example>
     <title>Exemple d'envoi d'un cookie avec <function>setcookie</function></title>
     <programlisting role="php">