Sync network functions (php#843)

lufei · Jan 20, 2024 · 3ca5141 · 3ca5141
1 parent b10b914
commit 3ca5141
Show file tree

Hide file tree

Showing 2 changed files with 34 additions and 8 deletions.
diff --git a/reference/network/functions/header.xml b/reference/network/functions/header.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
 <!-- $Author$ -->
-<!-- EN-Revision: 6b053588fb22cdc167766d4aa0e2f87cd52ecb32 Maintainer: zhoumengkang Status: ready -->
+<!-- EN-Revision: 5c1ccc6e24e5d470e75ef0a5887c2ff583266375 Maintainer: zhoumengkang Status: ready -->
 <!-- CREDITS: Luffy -->
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.header">
  <refnamediv>
@@ -189,6 +189,25 @@ header("Expires: Sat, 26 Jul 1997 05:00:00 GMT"); // 过去的日期
     </para>
    </example>
   </para>
+  <para>
+   <example>
+    <title>设置一个 Cookie</title>
+    <para>
+     <function>setcookie</function> 提供了一个方便的方式来设置 Cookie。
+     要设置一个包含 <function>setcookie</function> 函数不支持的属性的 Cookie，可以使用 <function>header</function>。
+    </para>
+    <para>
+     例如，以下代码设置了一个包含 <literal>Partitioned</literal> 属性的 Cookie。
+    </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,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5d6153f896f4698bc2df1a41db1271075dd3b62d Maintainer: daijie Status: ready -->
+<!-- EN-Revision: 5c1ccc6e24e5d470e75ef0a5887c2ff583266375 Maintainer: daijie Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.setcookie" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -98,7 +98,7 @@
       <para>
        Cookie 的有效域名/子域名。设置成子域名（例如 <literal>'www.example.com'</literal>），会使
        Cookie 对这个子域名和它的三级域名有效（例如 w2.www.example.com）。要让 Cookie
-       对整个域名有效（包括它的全部子域名），只要设置成域名就可以了（这个例子里是 <literal>'example.com'</literal>）。
+       对整个域名有效（包括它的全部子域名），只要设置成域名就可以了（这个示例里是 <literal>'example.com'</literal>）。
       </para>
       <para>
        旧版浏览器仍然在使用废弃的 <link xlink:href="&url.rfc;2109">RFC 2109</link>，需要一个前置的点
@@ -138,6 +138,13 @@
        <literal>Strict</literal>。如果没有指定任何允许的选项，它们的默认值与显式参数的默认值相同。如果省略
        <literal>samesite</literal> 元素，则不设置 SameSite cookie 属性。
       </para>
+      <para>
+       <note>
+        <para>
+         要设置一个包含不在列出的关键字中的属性的 Cookie，使用 <function>header</function>。
+        </para>
+       </note>
+      </para>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -186,9 +193,9 @@
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
-   发送 cookie 的几个例子：
+   以下示例展示了一些发送 Cookie 的方法。
    <example>
-    <title><function>setcookie</function> 发送例子</title>
+    <title><function>setcookie</function> 发送示例</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -205,7 +212,7 @@ setcookie("TestCookie", $value, time()+3600, "/~rasmus/", "example.com", 1);
   <para>
    注意：在发送 Cookie 时，值的部分会被自动 urlencode 编码。收到 Cookie 时，会自动解码，并赋值到可变的
    Cookie 名称上。如果不想被编码，可以使用 <function>setrawcookie</function>
-   代替。在脚本里查看我们的测试 Cookie 的内容，使用下面的一个例子：
+   代替。在脚本里查看我们的测试 Cookie 的内容，使用下面的一个示例：
   </para>
   <para>
    <informalexample>
@@ -224,9 +231,9 @@ print_r($_COOKIE);
   </para>
   <para>
    <example>
-    <title><function>setcookie</function> 删除例子</title>
+    <title><function>setcookie</function> 删除示例</title>
     <para>
-     要删除一个 Cookie，应该设置过期时间为过去，以触发浏览器的删除机制。下面的例子展示了如何删除上个例子里的 Cookie：
+     要删除一个 Cookie，应该设置过期时间为过去，以触发浏览器的删除机制。下面的示例展示了如何删除上个示例里的 Cookie：
     </para>
     <programlisting role="php">
 <![CDATA[