php · sy-records · Dec 6, 2024 · Dec 5, 2024
diff --git a/appendices/filters.xml b/appendices/filters.xml
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: da4977f316e4a05be800e865b979c10d19436112 Maintainer: mowangjuanzi Status: ready -->
+<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: mowangjuanzi Status: ready -->
+<!-- CREDITS: Luffy -->
 <appendix xml:id="filters" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>可用过滤器列表</title>
  <para>
@@ -253,7 +254,7 @@ fclose($fp);
     <parameter>window</parameter>是压缩回溯窗口大小，以二的次方表示。
      更高的值（大到 15 —— 32768 字节）产生更好的压缩效果但消耗更多内存，
      低的值（低到 9 —— 512 字节）产生产生较差的压缩效果但内存消耗低。
-     目前默认的 <parameter>window</parameter> 大小是 <constant>15</constant>。
+     目前默认的 <parameter>window</parameter> 大小是 <literal>15</literal>。
 
     <parameter>memory</parameter>用来指示要分配多少工作内存。
      合法的数值范围是从 1（最小分配）到 9（最大分配）。

diff --git a/language/predefined/interfaces.xml b/language/predefined/interfaces.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: ce78d59569fcae6286c46abe1b781a0b6fc594c0 Maintainer: HonestQiao Status: ready -->
-<!-- CREDITS: mowangjuanzi -->
+<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: HonestQiao Status: ready -->
+<!-- CREDITS: mowangjuanzi, Luffy -->
 <part xml:id="reserved.interfaces" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>预定义接口和类</title>
 
@@ -29,6 +29,7 @@
  &language.predefined.unitenum;
  &language.predefined.backedenum;
  &language.predefined.sensitiveparametervalue;
+ &language.predefined.php-incomplete-class;
 
 </part>
 

diff --git a/language/predefined/php-incomplete-class.xml b/language/predefined/php-incomplete-class.xml
@@ -0,0 +1,147 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: c0e48705eb88453af785e0e4a6cbd526085dfe3a Maintainer: Luffy Status: ready -->
+<reference xml:id="class.php-incomplete-class" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+
+ <title>__PHP_Incomplete_Class 类</title>
+ <titleabbrev>__PHP_Incomplete_Class</titleabbrev>
+
+ <partintro>
+
+  <section xml:id="php-incomplete-class.intro">
+   &reftitle.intro;
+   <para>
+    由 <function>unserialize</function> 创建的在尝试反序列化未定义类或未在 <function>unserialize</function>
+    的 <parameter>options</parameter> 数组的 <literal>allowed_classes</literal>
+    中列出的类。
+   </para>
+
+   <para>
+    在 PHP 7.2.0 之前，对 <classname>__PHP_Incomplete_Class</classname> 类使用 <function>is_object</function>
+    会返回 &false;。从 PHP 7.2.0 开始，将返回 &true;。
+   </para>
+  </section>
+
+  <section xml:id="php-incomplete-class.synopsis">
+   &reftitle.classsynopsis;
+
+   <classsynopsis class="class">
+    <ooclass>
+     <modifier>final</modifier>
+     <classname>__PHP_Incomplete_Class</classname>
+    </ooclass>
+   </classsynopsis>
+
+   <para>
+    此类没有默认属性或方法。
+    由 <function>unserialize</function> 创建时，
+    除了所有反序列化的属性和值之外，
+    对象还将具有一个 <literal>__PHP_Incomplete_Class_Name</literal> 属性，
+    该属性将包含反序列化类的名称。
+   </para>
+  </section>
+
+  <section xml:id="php-incomplete-class.changelog" role="changelog">
+   &reftitle.changelog;
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        此类现在是 <literal>final</literal>。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </section>
+
+  <section xml:id="php-incomplete-class.examples" role="examples">
+   &reftitle.examples;
+   <example xml:id="php-incomplete-class.basic-example">
+    <title>由 <function>unserialize</function> 创建</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+class MyClass
+{
+    public string $property = "myValue";
+}
+
+$myObject = new MyClass;
+
+$foo = serialize($myObject);
+
+// unserializes all objects into __PHP_Incomplete_Class objects
+$disallowed = unserialize($foo, ["allowed_classes" => false]);
+
+var_dump($disallowed);
+
+// unserializes all objects into __PHP_Incomplete_Class objects except those of MyClass2 and MyClass3
+$disallowed2 = unserialize($foo, ["allowed_classes" => ["MyClass2", "MyClass3"]]);
+
+var_dump($disallowed2);
+
+// unserializes undefined class into __PHP_Incomplete_Class object
+$undefinedClass = unserialize('O:16:"MyUndefinedClass":0:{}');
+
+var_dump($undefinedClass);
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+
+object(__PHP_Incomplete_Class)#2 (2) {
+  ["__PHP_Incomplete_Class_Name"]=>
+  string(7) "MyClass"
+  ["property"]=>
+  string(7) "myValue"
+}
+object(__PHP_Incomplete_Class)#3 (2) {
+  ["__PHP_Incomplete_Class_Name"]=>
+  string(7) "MyClass"
+  ["property"]=>
+  string(7) "myValue"
+}
+object(__PHP_Incomplete_Class)#4 (1) {
+  ["__PHP_Incomplete_Class_Name"]=>
+  string(16) "MyUndefinedClass"
+}
+
+]]>
+    </screen>
+   </example>
+  </section>
+
+ </partintro>
+
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/event/eventconfig/setmaxdispatchinterval.xml b/reference/event/eventconfig/setmaxdispatchinterval.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- $Author: Avenger $ -->
-<!-- EN-Revision: da9d81816187b87c03a6cd92a3c3b833f039485c Maintainer: mowangjuanzi Status: ready -->
+<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: mowangjuanzi Status: ready -->
+<!-- CREDITS: Luffy -->
 <refentry xml:id="eventconfig.setmaxdispatchinterval" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>EventConfig::setMaxDispatchInterval</refname>
@@ -47,7 +47,7 @@
     <listitem>
      <para>
       Libevent 应该停止运行回调并检查更多时间的间隔，如果为
-      <constant>0</constant>，则没有这样的间隔。
+      <literal>0</literal>，则没有这样的间隔。
      </para>
     </listitem>
    </varlistentry>
@@ -70,9 +70,9 @@
      <para>
       不应执行低于 <parameter>max_interval</parameter> 和 
       <parameter>max_callbacks</parameter> 优先级的事件。如果设置为 
-      <constant>0</constant>，它适用于每个优先级事件；如果设置为 
-      <constant>1</constant>，它适用于优先级在 
-      <constant>1</constant>及其以上的事件，以此类推。
+      <literal>0</literal>，它适用于每个优先级事件；如果设置为 
+      <literal>1</literal>，它适用于优先级在 
+      <literal>1</literal>及其以上的事件，以此类推。
      </para>
     </listitem>
    </varlistentry>

diff --git a/reference/filesystem/functions/stat.xml b/reference/filesystem/functions/stat.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1f7d8b1ee9e6c7350857ddc8bfce248a65a29787 Maintainer: HonestQiao Status: ready -->
-<!-- CREDITS: mowangjuanzi -->
+<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: HonestQiao Status: ready -->
+<!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.stat" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>stat</refname>
@@ -162,37 +162,37 @@
      </thead>
      <tbody>
       <row>
-       <entry><constant>0140000</constant></entry>
+       <entry><literal>0140000</literal></entry>
        <entry>socket</entry>
       </row>
       <row>
-       <entry><constant>0120000</constant></entry>
+       <entry><literal>0120000</literal></entry>
        <entry>link</entry>
       </row>
       <row>
-       <entry><constant>0100000</constant></entry>
+       <entry><literal>0100000</literal></entry>
        <entry>常规文件</entry>
       </row>
       <row>
-       <entry><constant>0060000</constant></entry>
+       <entry><literal>0060000</literal></entry>
        <entry>块设备</entry>
       </row>
       <row>
-       <entry><constant>0040000</constant></entry>
+       <entry><literal>0040000</literal></entry>
        <entry>目录</entry>
       </row>
       <row>
-       <entry><constant>0020000</constant></entry>
+       <entry><literal>0020000</literal></entry>
        <entry>字符设备</entry>
       </row>
       <row>
-       <entry><constant>0010000</constant></entry>
+       <entry><literal>0010000</literal></entry>
        <entry>fifo</entry>
       </row>
      </tbody>
     </tgroup>
    </table>
-   例如普通文件可能是 <constant>0100644</constant>，目录可能是 <constant>0040755</constant>。
+   例如普通文件可能是 <literal>0100644</literal>，目录可能是 <literal>0040755</literal>。
   </para>
   <para>
    如果出错，<function>stat</function> 返回 &false;。

diff --git a/reference/mcrypt/constants.xml b/reference/mcrypt/constants.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: yuanyuqiang Status: ready -->
-<!-- CREDITS: mowangjuanzi -->
+<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: yuanyuqiang Status: ready -->
+<!-- CREDITS: mowangjuanzi, Luffy -->
 <appendix xml:id="mcrypt.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
@@ -67,12 +67,12 @@
   <itemizedlist>
    <listitem>
     <simpara>
-     <constant>"ctr"</constant> (<literal>counter mode</literal>) 是一种流式加密模式。
+     <literal>"ctr"</literal> (<literal>counter mode</literal>) 是一种流式加密模式。
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     <constant>"ncfb"</constant> (<literal>cipher feedback,
+     <literal>"ncfb"</literal> (<literal>cipher feedback,
      in n-bit mode</literal>)，类似于 <literal>CFB</literal> 模式，
      但是它会对于算法设定的整块数据进行操作。
     </simpara>

diff --git a/reference/oci8/functions/oci-set-prefetch.xml b/reference/oci8/functions/oci-set-prefetch.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5e41012cfdf8f2eff5fa56de446c7656afac536c Maintainer: HonestQiao Status: ready -->
-<!-- CREDITS: dallas, mowangjuanzi -->
+<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: HonestQiao Status: ready -->
+<!-- CREDITS: dallas, mowangjuanzi, Luffy -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.oci-set-prefetch">
  <refnamediv>
   <refname>oci_set_prefetch</refname>
@@ -154,8 +154,9 @@ oci_close($conn);
    </example>
   </para>
   <para>
-   如果 PHP OCI8 从 REF CURSOR 读取，然后将 REF CURSOR 传递回第二个 PL/SQL 过程以进行进一步处理，则将 REF CURSOR
-   预读取数设置为 0 以避免行从结果集中“丢失”。预读取值是在每个 OCI8 内部请求数据库中提取的额外行数，因此将其设置为 0 意味着一次只提取一行。
+   如果 PHP OCI8 从 REF CURSOR 获取数据，然后将 REF CURSOR 传回给第二个 PL/SQL 过程进行进一步处理，则将 REF CURSOR 预读取值设置为
+   <literal>0</literal>，以避免结果集中的行被“丢失”。预读取值是每个 OCI8 内部请求到数据库中获取的额外行数，因此将其设置为
+   <literal>0</literal> 意味着每次只获取一行。
    <example>
     <title>将 REF CURSOR 传回 Oracle 时设置读取值</title>
     <programlisting role="php">

diff --git a/reference/sockets/functions/socket-read.xml b/reference/sockets/functions/socket-read.xml
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 14dc7c47365f2b71f6c907a5ba5bccf42534d5a9 Maintainer: her-cat Status: ready -->
+<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: her-cat Status: ready -->
+<!-- CREDITS: Luffy -->
 <refentry xml:id="function.socket-read" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>socket_read</refname>
@@ -41,7 +42,7 @@
      <listitem>
       <para>
        <parameter>length</parameter> 参数指定了最大能够读取的字节数。否则您可以使用
-       <constant>\r</constant>、<constant>\n</constant>、<constant>\0</constant>
+       <literal>\r</literal>、<literal>\n</literal>、<literal>\0</literal>
        结束读取（根据 <parameter>mode</parameter> 参数设置，请参见下文）。
       </para>
      </listitem>

diff --git a/reference/var/functions/unserialize.xml b/reference/var/functions/unserialize.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4150dc92749c177758efe59eab23b6a5d32ffda2 Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: HonestQiao Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.unserialize" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -141,6 +141,12 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.3.0</entry>
+       <entry>
+        当传递的字符串有未消耗的数据时，现在会发出 <constant>E_WARNING</constant>。
+       </entry>
+      </row>
       <row>
        <entry>8.3.0</entry>
        <entry>