Update appendices

Author: mowangjuanzi

appendices/migration80/incompatible.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: avenger Status: ready -->
+<!-- EN-Revision: b94d63fc0884d83ba43433ab33cc4810d955bf6d Maintainer: avenger Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <sect1 xml:id="migration80.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>不向后兼容的变更</title>
@@ -1460,7 +1460,7 @@ echo file_get_contents('http://example.org', false, $ctx);
   <title>XMLReader</title>
 
   <para>
-   <methodname>XMLReader::open</methodname> 和 <methodname>XMLReader::xml</methodname>
+   <methodname>XMLReader::open</methodname> 和 <methodname>XMLReader::XML</methodname>
    现在是静态方法。也可以作为实例方法调用，但如果继承类需要覆盖这些方法，要声明为 static。
   </para>
  </sect2>

appendices/migration84/new-features.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8a9f4bd9d54a809d66f32d35ec60eb2b7353f76e Maintainer: mowangjuanzi Status: partial -->
+<!-- EN-Revision: 8a9f4bd9d54a809d66f32d35ec60eb2b7353f76e Maintainer: mowangjuanzi Status: ready -->
 <sect1 xml:id="migration84.new-features">
  <title>新功能</title>
 
@@ -195,33 +195,23 @@ $object = $reflector->newLazyGhost($initializer);
   </simpara>
 
   <simpara>
-   Added <constant>CURL_HTTP_VERSION_3</constant> and
-   <constant>CURL_HTTP_VERSION_3ONLY</constant> constants (available
-   since libcurl 7.66 and 7.88) as available options for
-   <constant>CURLOPT_HTTP_VERSION</constant>.
+   新增 <constant>CURL_HTTP_VERSION_3</constant> 和 <constant>CURL_HTTP_VERSION_3ONLY</constant>
+   常量（自 libcurl 7.66 和 7.88 起可用）作为 <constant>CURLOPT_HTTP_VERSION</constant> 的可用选项。
   </simpara>
 
   <simpara>
-   Added <constant>CURLOPT_PREREQFUNCTION</constant> as a cURL option that
-   accepts a <type>callable</type> to be called after the connection is made,
-   but before the request is sent.
-   This callable must return either <constant>CURL_PREREQFUNC_OK</constant> or
-   <constant>CURL_PREREQFUNC_ABORT</constant> to allow or abort the request.
+   新增 <constant>CURLOPT_PREREQFUNCTION</constant> 作为 cURL 选项，该选项接受在建立连接后但在发送请求之前调用的
+   <type>callable</type>。此 callable 必须返回 <constant>CURL_PREREQFUNC_OK</constant> 或
+   <constant>CURL_PREREQFUNC_ABORT</constant> 以允许或中止请求。
   </simpara>
 
   <simpara>
-   Added <constant>CURLOPT_SERVER_RESPONSE_TIMEOUT</constant>,
-   which was formerly known as <constant>CURLOPT_FTP_RESPONSE_TIMEOUT</constant>.
-   Both constants hold the same value.
+   新增 CURLOPT_SERVER_RESPONSE_TIMEOUT，以前称为 <constant>CURLOPT_FTP_RESPONSE_TIMEOUT</constant>。两个常量都具有相同的值。
   </simpara>
 
   <para>
-   Added <constant>CURLOPT_DEBUGFUNCTION</constant> as a cURL option that
-   accepts a <type>callable</type> that gets called during the request lifetime
-   with the <classname>CurlHandle</classname> object,
-   an integer containing the debug message type, and a string containing the
-   debug message.
-   The debug message type is one of the following constants:
+   新增 <constant>CURLOPT_DEBUGFUNCTION</constant> 作为 cURL 选项，该选项接受在请求生命周期内使用
+   <classname>CurlHandle</classname> 对象调用的 <type>callable</type>、包含调试消息类型的整数以及包含调试消息的字符串。调试消息类型是以下常量之一：
    <simplelist>
     <member><constant>CURLINFO_TEXT</constant></member>
     <member><constant>CURLINFO_HEADER_IN</constant></member>
@@ -231,19 +221,14 @@ $object = $reflector->newLazyGhost($initializer);
     <member><constant>CURLINFO_SSL_DATA_IN</constant></member>
     <member><constant>CURLINFO_SSL_DATA_OUT</constant></member>
    </simplelist>
-   Once this option is set, <constant>CURLINFO_HEADER_OUT</constant>
-   must not be set because it uses the same libcurl functionality.
+   一旦设置了此选项，就不能设置 <constant>CURLINFO_HEADER_OUT</constant>，因为它使用相同的 libcurl 功能。
   </para>
 
   <simpara>
-   The <function>curl_getinfo</function> now returns an additional
-   <literal>posttransfer_time_us</literal> key, containing the number of
-   microseconds from the start until the last byte is sent.
-   When a redirect is followed, the time from each request is added together.
-   This value can also be retrieved by passing
-   <constant>CURLINFO_POSTTRANSFER_TIME_T</constant> to the
-   <function>curl_getinfo</function> <parameter>option</parameter> parameter.
-   This requires libcurl 8.10.0 or later.
+   <function>curl_getinfo</function> 现在返回一个额外的 <literal>posttransfer_time_us</literal>
+   key，其中包含从开始到发送最后一个字节的微秒数。当重定向之后，每个请求的时间都会加在一起。也可以通过将
+   <constant>CURLINFO_POSTTRANSFER_TIME_T</constant> 传递给 <function>curl_getinfo</function>
+   <parameter>option</parameter> 参数来检索此值。这需要 libcurl 8.10.0 或更高版本。
   </simpara>
  </sect2>
 
@@ -284,50 +269,38 @@ $object = $reflector->newLazyGhost($initializer);
   <title>Intl</title>
 
   <simpara>
-   Added the <constant>NumberFormatter::ROUND_HALFODD</constant> to
-   complement the existing <constant>NumberFormatter::ROUND_HALFEVEN</constant>
-   functionality.
+   新增 <constant>NumberFormatter::ROUND_HALFODD</constant> 来补充现有的 <constant>NumberFormatter::ROUND_HALFEVEN</constant> 功能。
   </simpara>
  </sect2>
 
  <sect2 xml:id="migration84.new-features.openssl">
   <title>OpenSSL</title>
 
   <simpara>
-   Added support for Curve25519 + Curve448 based keys.
-   Specifically x25519, ed25519, x448 and ed448 fields are supported in
-   <function>openssl_pkey_new</function>,
-   <function>openssl_pkey_get_details</function>,
-   <function>openssl_sign</function>, and
-   <function>openssl_verify</function> were extended to support those keys.
+   添加了对基于 Curve25519 + Curve448 密钥的支持。具体来说
+   <function>openssl_pkey_new</function>、<function>openssl_pkey_get_details</function>、<function>openssl_sign</function> 和
+   <function>openssl_verify</function> 中支持 x25519、ed25519、x448 和 ed448 字段，并进行了扩展以支持这些密钥。
   </simpara>
 
   <simpara>
-   Implement PASSWORD_ARGON2 password hashing.
-   Requires OpenSSL 3.2 and NTS build.
+   实现 PASSWORD_ARGON2 密码哈希处理。需要 OpenSSL 3.2 和 NTS 版本。
   </simpara>
  </sect2>
 
  <sect2 xml:id="migration84.new-features.pcre">
   <title>PCRE</title>
 
   <simpara>
-   The bundled pcre2lib has been updated to version 10.44.
-   As a consequence, LoongArch JIT support has been added, spaces
-   are now allowed between braces in Perl-compatible items, and
-   variable-length lookbehind assertions are now supported.
+   捆绑的 pcre2lib 已更新至 10.44 版本。因此，添加了 LoongArch JIT 支持，现在允许在与 Perl 兼容项目中的花括号之间使用空格，并且现在支持可变长度的后向断言。
   </simpara>
 
   <simpara>
-   With pcre2lib version 10.44, the maximum length of named capture groups
-   has changed from <literal>32</literal> to <literal>128</literal>.
+   随着 pcre2lib 版本 10.44 的推出，命名捕获组的最大长度已从 <literal>32</literal> 更改为 <literal>128</literal>。
   </simpara>
 
   <simpara>
-   Added support for the <literal>r</literal> (PCRE2_EXTRA_CASELESS_RESTRICT)
-   modifier, as well as the <literal>(?r)</literal> mode modifier.
-   When enabled along with the case-insensitive modifier (<literal>i</literal>),
-   the expression locks out mixing of ASCII and non-ASCII characters.
+   添加了对 <literal>r</literal>（PCRE2_EXTRA_CASELESS_RESTRICT）修饰符以及 <literal>(?r)</literal>
+   模式修饰符的支持。当与不区分大小写的修饰符 (<literal>i</literal>) 一起启用时，表达式会阻止 ASCII 和非 ASCII 字符的混合。
   </simpara>
  </sect2>
 
@@ -336,24 +309,19 @@ $object = $reflector->newLazyGhost($initializer);
 
   <!-- RFC: https://wiki.php.net/rfc/pdo_driver_specific_subclasses -->
   <simpara>
-   Added support for driver-specific subclasses.
-   This RFC adds subclasses for PDO in order to better support
-   database-specific functionalities.
-   The new classes are instantiatable either via calling the
-   <methodname>PDO::connect</methodname> method or by instantiating an instance
-   of the driver-specific subclass directly.
+   新增对特定驱动程序子类的支持。此 RFC 添加了 PDO 的子类，以便更好地支持特定于数据库的功能。新的类可通过调用 <methodname>PDO::connect</methodname>
+   方法或直接实例化特定驱动程序子类的实例来实例化。
   </simpara>
 
   <!-- RFC: https://wiki.php.net/rfc/pdo_driver_specific_parsers -->
   <para>
-   Added support for driver specific SQL parsers.
-   The default parser supports:
+   新增对特定驱动程序的 SQL 解析器的支持。默认解析器支持：
    <simplelist>
     <member>
-     single and double-quoted literals, with doubling as escaping mechanism
+     单引号和双引号文字，使用双引号作为转义机制
     </member>
     <member>
-     two-dashes and non-nested C-style comments
+     双破折号和非嵌套的 C 风格注释
     </member>
    </simplelist>
   </para>
@@ -364,18 +332,16 @@ $object = $reflector->newLazyGhost($initializer);
 
   <!-- RFC: https://wiki.php.net/rfc/pdo_driver_specific_parsers -->
   <para>
-   Added a custom parser supporting:
+   新增自定义解析器支持：
    <simplelist>
     <member>
-     single and double-quoted literals, with doubling and backslash as escaping
-     mechanism
+     单引号和双引号文字，使用双引号作为转义机制
     </member>
     <member>
-     backtick literal identifiers and with doubling as escaping mechanism
+     反引号文字标识符并且双写反引号作为转义机制
     </member>
     <member>
-     two dashes followed by at least 1 whitespace, non-nested C-style comments,
-     and hash-comments
+     两个破折号后跟至少 1 个空格、非嵌套的 C 风格注释和哈希注释（以 # 开头的注释）
     </member>
    </simplelist>
   </para>
@@ -386,23 +352,22 @@ $object = $reflector->newLazyGhost($initializer);
 
   <!-- RFC: https://wiki.php.net/rfc/pdo_driver_specific_parsers -->
   <para>
-   Added a custom parser supporting:
+   新增自定义解析器支持：
    <simplelist>
     <member>
-     single and double-quoted literals, with doubling as escaping mechanism
+     单引号和双引号文字，使用双引号作为转义机制
     </member>
     <member>
-     C-style "escape" string literals (<literal>E'string'</literal>)
+     C 风格“转义”字符串文字（<literal>E'string'</literal>）
     </member>
     <member>
      dollar-quoted string literals
     </member>
     <member>
-     two-dashes and C-style comments (non-nested)
+     双破折号和 C 风格注释（非嵌套）
     </member>
     <member>
-     support for <literal>??</literal> as escape sequence for the
-     <literal>?</literal> operator
+     支持 <literal>??</literal> 作为 <literal>?</literal> 运算符的转义序列
     </member>
    </simplelist>
   </para>
@@ -413,17 +378,16 @@ $object = $reflector->newLazyGhost($initializer);
 
   <!-- RFC: https://wiki.php.net/rfc/pdo_driver_specific_parsers -->
   <para>
-   Added a custom parser supporting:
+   新增自定义解析器支持：
    <simplelist>
     <member>
-     single, double-quoted, and backtick literals, with doubling as
-     escaping mechanism
+     单引号、双引号和反引号文字，并带有转义机制
     </member>
     <member>
-     square brackets quoting for identifiers
+     方括号引用标识符
     </member>
     <member>
-     two-dashes and C-style comments (non-nested)
+     双破折号和 C 风格注释（非嵌套）
     </member>
    </simplelist>
   </para>
@@ -433,31 +397,28 @@ $object = $reflector->newLazyGhost($initializer);
   <title>Phar</title>
 
   <simpara>
-   Added support for the Unix timestamp extension for Zip archives.
+   Zip 档案新增对 Unix 时间戳扩展的支持。
   </simpara>
  </sect2>
 
- <sect2 xml:id="migration84.new-features.readfile">
-  <title>Readfile</title>
+ <sect2 xml:id="migration84.new-features.readline">
+  <title>Readline</title>
 
   <simpara>
-   Added ability to change the <literal>.php_history</literal> path through
-   the <envar>PHP_HISTFILE</envar> environment variable.
+   新增通过 <envar>PHP_HISTFILE</envar> 环境变量更改 <literal>.php_history</literal> 路径的功能。
   </simpara>
  </sect2>
 
- <sect2 xml:id="migration84.new-features.readline">
-  <title>Readline</title>
+ <sect2 xml:id="migration84.new-features.reflection">
+  <title>Reflection</title>
 
   <simpara>
-   <classname>ReflectionAttribute</classname> now contains a
-   <property>name</property> property to improve the debugging experience.
+   <classname>ReflectionAttribute</classname> 现在包含 <property>name</property> 属性，以改善调试体验。
   </simpara>
 
   <simpara>
-   <methodname>ReflectionClassConstant::__toString</methodname> and
-   <methodname>ReflectionProperty::__toString</methodname> now returns the
-   attached doc comments.
+   <methodname>ReflectionClassConstant::__toString</methodname> 和
+   <methodname>ReflectionProperty::__toString</methodname> 现在返回附加的文档注释。
   </simpara>
 
   <!-- RFC: https://wiki.php.net/rfc/lazy-objects -->
@@ -521,7 +482,7 @@ $object = $reflector->newLazyGhost($initializer);
   </simpara>
 
   <simpara>
-   Session persistence now works with a shared session module.
+   持久会话现在可与共享会话模块一起使用。
   </simpara>
  </sect2>
 
@@ -531,42 +492,35 @@ $object = $reflector->newLazyGhost($initializer);
   <!-- RFC: https://wiki.php.net/rfc/correctly_name_the_rounding_mode_and_make_it_an_enum -->
   <simpara>
    <!-- Should this use <enumname> -->
-   Added a new <classname>RoundingMode</classname> enum with clearer naming
-   and improved discoverability compared to the
-   <constant>PHP_ROUND_<replaceable>*</replaceable></constant> constants.
-   Moreover, four new rounding modes were added which are only available via
-   the new <classname>RoundingMode</classname> enum.
+   新增 <classname>RoundingMode</classname> 枚举，与 <constant>PHP_ROUND_<replaceable>*</replaceable></constant>
+   常量相比，其命名更清晰，可发现性更高。此外，还添加了四种新的舍入模式，这些模式仅可通过新的 <classname>RoundingMode</classname> 枚举使用。
   </simpara>
  </sect2>
 
  <sect2 xml:id="migration84.new-features.xsl">
   <title>XSL</title>
 
   <simpara>
-   It is now possible to use parameters that contain both single and double
-   quotes.
+   现在可以使用包含单引号和双引号的参数。
   </simpara>
 
   <!-- RFC: https://wiki.php.net/rfc/improve_callbacks_dom_and_xsl -->
   <simpara>
-   It is now possible to pass any callable to
-   <methodname>XSLTProcessor::registerPhpFunctions</methodname>.
+   现在可以将任何 callable 传递给 <methodname>XSLTProcessor::registerPhpFunctions</methodname>。
    <!-- TODO Mention XSLTProcessor::registerPHPFunctionNS ? -->
   </simpara>
 
   <simpara>
-   Added <property>XSLTProcessor::$maxTemplateDepth</property> and
-   <property>XSLTProcessor::$maxTemplateVars</property>
-   to control the recursion depth of XSL template evaluation.
+   添加了 <property>XSLTProcessor::$maxTemplateDepth</property> 和 <property>XSLTProcessor::$maxTemplateVars</property>
+   来控制 XSL 模板计算的递归深度。
   </simpara>
  </sect2>
 
  <sect2 xml:id="migration84.new-features.zip">
   <title>Zip</title>
 
   <simpara>
-   Added the <constant>ZipArchive::ER_TRUNCATED_ZIP</constant>
-   constant, which was added in libzip 1.11.
+   新增 <constant>ZipArchive::ER_TRUNCATED_ZIP</constant> 常量，libzip 1.11 中添加。
   </simpara>
  </sect2>