From 647ed75ca57df7f0b42096bf0bc520f860bf88bd Mon Sep 17 00:00:00 2001
From: Luffy <lufei@php.net>
Date: Tue, 15 Oct 2024 07:54:00 +0800
Subject: [PATCH] Sync outdated files (#921)

---
 appendices/tokens.xml                         |  19 +-
 language/types/string.xml                     | 333 ++++++++++--------
 reference/filesystem/functions/glob.xml       |   4 +-
 reference/memcache/memcache/delete.xml        |  15 +-
 reference/outcontrol/constants.xml            |   7 +-
 .../outcontrol/user-level-output-buffers.xml  |  15 +-
 6 files changed, 216 insertions(+), 177 deletions(-)

diff --git a/appendices/tokens.xml b/appendices/tokens.xml
index b267d27c8..05044f934 100755
--- a/appendices/tokens.xml
+++ b/appendices/tokens.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision:270a871223343be9280a3e8a133a5467a3e82908 Maintainer: haohappy Status: ready -->
+<!-- EN-Revision:349f6f64ec46a288c376c868721fdad21929fdb2 Maintainer: haohappy Status: ready -->
 <!-- CREDITS: class007, mowangjuanzi, Luffy -->
 <appendix xml:id="tokens" xmlns="http://docbook.org/ns/docbook">
  <title>解析器记号（token）列表</title>
@@ -196,7 +196,10 @@ defined('T_FN') || define('T_FN', 10001);
     <row xml:id="constant.t-curly-open">
      <entry><constant>T_CURLY_OPEN</constant></entry>
      <entry>{$</entry>
-     <entry><link linkend="language.types.string.parsing.complex">复杂变量解析语法</link></entry>
+     <entry>
+      <link linkend="language.types.string.parsing.advanced">高级</link>
+      变量字符串插值
+     </entry>
     </row>
     <row xml:id="constant.t-dec">
      <entry><constant>T_DEC</constant></entry>
@@ -244,7 +247,10 @@ defined('T_FN') || define('T_FN', 10001);
     <row xml:id="constant.t-dollar-open-curly-braces">
      <entry><constant>T_DOLLAR_OPEN_CURLY_BRACES</constant></entry>
      <entry>${</entry>
-     <entry><link linkend="language.types.string.parsing.complex">复杂变量解析语法</link></entry>
+     <entry>
+      <link linkend="language.types.string.parsing.basic">基本</link>
+      变量字符串插值
+     </entry>
     </row>
     <row xml:id="constant.t-double-arrow">
      <entry><constant>T_DOUBLE_ARROW</constant></entry>
@@ -648,7 +654,7 @@ defined('T_FN') || define('T_FN', 10001);
     <row xml:id="constant.t-paamayim-nekudotayim">
      <entry><constant>T_PAAMAYIM_NEKUDOTAYIM</constant></entry>
      <entry>::</entry>
-     <entry><link linkend="language.oop5.paamayim-nekudotayim">::</link>。也定义为
+     <entry><link linkend="language.oop5.paamayim-nekudotayim">范围解析</link>。也定义为
       <constant>T_DOUBLE_COLON</constant>。</entry>
     </row>
     <row xml:id="constant.t-plus-equal">
@@ -773,7 +779,10 @@ defined('T_FN') || define('T_FN', 10001);
     <row xml:id="constant.t-string-varname">
      <entry><constant>T_STRING_VARNAME</constant></entry>
      <entry>"${a</entry>
-     <entry><link linkend="language.types.string.parsing.complex">复杂变量解析语法</link></entry>
+     <entry>
+      <link linkend="language.variables.variable">可变变量</link>
+      在字符串中插值
+     </entry>
     </row>
     <row xml:id="constant.t-switch">
      <entry><constant>T_SWITCH</constant></entry>
diff --git a/language/types/string.xml b/language/types/string.xml
index cbb15cb48..4a3808064 100644
--- a/language/types/string.xml
+++ b/language/types/string.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: affa37e16f562d9297e83b2e21ec416aadc8b72d Maintainer: dallas Status: ready -->
+<!-- EN-Revision: 887c21f977369af0808290874dc2c279ad4d0af2 Maintainer: dallas Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <sect1 xml:id="language.types.string">
  <title>String 字符串</title>
@@ -104,7 +104,7 @@ echo 'Variables do not $expand $either';
    <title>双引号</title>
 
    <para>
-    如果字符串是包围在双引号（"）中， PHP 将对以下特殊的字符进行解析：
+    如果字符串是包围在双引号（<literal>"</literal>)）中， PHP 将对以下特殊的字符进行解析：
    </para>
 
    <table>
@@ -186,7 +186,7 @@ echo 'Variables do not $expand $either';
 
    <para>
     用双引号定义的字符串最重要的特征是变量会被解析，详见<link 
-    linkend="language.types.string.parsing">变量解析</link>。
+    linkend="language.types.string.parsing">变量插值</link>。
    </para>
   </sect3>
   
@@ -550,7 +550,7 @@ FOOBAR;
    <para>
     就象 heredoc 结构类似于双引号字符串，Nowdoc 结构是类似于单引号字符串的。Nowdoc
     结构很象 heredoc 结构，但是 nowdoc
-    中<emphasis>不进行解析操作</emphasis>。这种结构很适合用于嵌入 PHP
+    中<emphasis>不进行字符串插值</emphasis>。这种结构很适合用于嵌入 PHP
     代码或其它大段文本而无需对其中的特殊字符进行转义。与 SGML 的
     <literal>&lt;![CDATA[ ]]&gt;</literal> 结构是用来声明大段的不用解析的文本类似，nowdoc 结构也有相同的特征。
    </para>
@@ -647,31 +647,25 @@ EOT;
   </sect3>
 
   <sect3 xml:id="language.types.string.parsing">
-   <title>变量解析</title>
+   <title>字符串插值</title>
 
    <simpara>
     当<type>字符串</type>用双引号或 heredoc 结构定义时，其中的<link
-    linkend="language.variables">变量</link>将会被解析。
+    linkend="language.variables">变量</link>可以进行替换。
    </simpara>
 
    <simpara>
     这里共有两种语法规则：一种<link
-    linkend="language.types.string.parsing.simple">简单</link>规则，一种<link
-    linkend="language.types.string.parsing.complex">复杂</link>规则。简单的语法规则是最常用和最方便的，它可以用最少的代码在一个
+    linkend="language.types.string.parsing.basic">基本</link>规则，一种<link
+    linkend="language.types.string.parsing.advanced">高级</link>规则。基本的语法规则是最常用和最方便的，它可以用最少的代码在一个
     <type>string</type> 中嵌入一个变量，一个 <type>array</type> 的值，或一个 <type>object</type> 的属性。
    </simpara>
 
-   <simpara>
-    复杂规则语法的显著标记是用花括号包围的表达式。
-   </simpara>
-
-   <sect4 xml:id="language.types.string.parsing.simple">
-    <title>简单语法</title>
-
+   <sect4 xml:id="language.types.string.parsing.basic">
+    <title>基本语法</title>
     <simpara>
-     当 PHP 解析器遇到一个美元符号（<literal>$</literal>）时，它会和其它很多解析器一样，去组合尽量多的标识以形成一个合法的变量名。可以用花括号来明确变量名的界线。
+     如果遇到一个美元符号（<literal>$</literal>），后面的字符会被解释为变量名，然后替换为变量的值。
     </simpara>
-
     <informalexample>
      <programlisting role="php">
 <![CDATA[
@@ -680,12 +674,6 @@ $juice = "apple";
 
 echo "He drank some $juice juice." . PHP_EOL;
 
-// 非故意。“s”是变量名的有效字符，因此指的是 $juices 而不是 $juice。
-echo "He drank some juice made of $juices." . PHP_EOL;
-
-// Explicitly specify the end of the variable name by enclosing the reference in braces.
-echo "He drank some juice made of {$juice}s.";
-
 ?>
 ]]>
      </programlisting>
@@ -693,42 +681,127 @@ echo "He drank some juice made of {$juice}s.";
      <screen>
 <![CDATA[
 He drank some apple juice.
-He drank some juice made of .
-He drank some juice made of apples.
 ]]>
      </screen>
     </informalexample>
 
     <simpara>
-     类似的，一个 <type>array</type> 索引或一个 <type>object</type>
-     属性也可被解析。数组索引要用方括号（<literal>]</literal>）来表示索引结束的边际，对象属性则是和上述的变量规则相同。
+     从形式上讲，基本变量替换语法的结构如下：
     </simpara>
+    <informalexample>
+     <programlisting>
+<![CDATA[
+string-variable::
+     variable-name   (offset-or-property)?
+   | ${   expression   }
 
-    <example>
-     <title>简单语法示例</title>
-     <programlisting role="php">
+offset-or-property::
+     offset-in-string
+   | property-in-string
+
+offset-in-string::
+     [   name   ]
+   | [   variable-name   ]
+   | [   integer-literal   ]
+
+property-in-string::
+     ->  name
+
+variable-name::
+     $   name
+
+name::
+     [a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*
+
+]]>
+     </programlisting>
+    </informalexample>
+
+    <warning>
+     <para>
+      <literal>${ expression }</literal> 语法从 PHP 8.2.0 开始被弃用，因为它可能被解释为
+      <link linkend="language.variables.variable">可变变量</link>：
+      <informalexample>
+       <programlisting role="php">
 <![CDATA[
 <?php
-$juices = array("apple", "orange", "koolaid1" => "purple");
+const foo = 'bar';
+$foo = 'foo';
+$bar = 'bar';
+var_dump("${foo}");
+var_dump("${(foo)}");
+?>
+]]>
+       </programlisting>
+       &example.outputs.82;
+       <screen>
+<![CDATA[
+Deprecated: Using ${var} in strings is deprecated, use {$var} instead in file on line 6
 
-echo "He drank some $juices[0] juice.".PHP_EOL;
-echo "He drank some $juices[1] juice.".PHP_EOL;
-echo "He drank some $juices[koolaid1] juice.".PHP_EOL;
+Deprecated: Using ${expr} (variable variables) in strings is deprecated, use {${expr}} instead in file on line 9
+string(3) "foo"
+string(3) "bar"
+]]>
+       </screen>
+       &example.outputs;
+       <screen>
+<![CDATA[
+string(3) "foo"
+string(3) "bar"
+]]>
+       </screen>
+      </informalexample>
+      <link linkend="language.types.string.parsing.advanced">高级</link> 字符串插值语法应该被使用。
+     </para>
+    </warning>
 
-class people {
-    public $john = "John Smith";
-    public $jane = "Jane Smith";
-    public $robert = "Robert Paulsen";
+    <note>
+     <simpara>
+      如果无法形成有效的变量名，美元符号会保持原样。
+     </simpara>
+     <informalexample>
+      <programlisting role="php">
+<![CDATA[
+<?php
+echo "No interpolation $  has happened\n";
+echo "No interpolation $\n has happened\n";
+echo "No interpolation $2 has happened\n";
+?>
+]]>
+      </programlisting>
+      &example.outputs;
+      <screen>
+<![CDATA[
+No interpolation $  has happened
+No interpolation $
+ has happened
+No interpolation $2 has happened
+]]>
+      </screen>
+     </informalexample>
+    </note>
+
+    <example>
+     <title>插值数组或属性的第一个维度值</title>
+     <programlisting role="php">
+      <![CDATA[
+<?php
+$juices = array("apple", "orange", "string_key" => "purple");
 
-    public $smith = "Smith";
+echo "He drank some $juices[0] juice.";
+echo PHP_EOL;
+echo "He drank some $juices[1] juice.";
+echo PHP_EOL;
+echo "He drank some $juices[string_key] juice.";
+echo PHP_EOL;
+
+class A {
+    public $s = "string";
 }
 
-$people = new people();
+$o = new A();
 
-echo "$people->john drank some $juices[0] juice.".PHP_EOL;
-echo "$people->john then said hello to $people->jane.".PHP_EOL;
-echo "$people->john's wife greeted $people->robert.".PHP_EOL;
-echo "$people->robert greeted the two $people->smiths."; // Won't work
+echo "Object value: $o->s.";
 ?>
 ]]>
      </programlisting>
@@ -738,21 +811,26 @@ echo "$people->robert greeted the two $people->smiths."; // Won't work
 He drank some apple juice.
 He drank some orange juice.
 He drank some purple juice.
-John Smith drank some apple juice.
-John Smith then said hello to Jane Smith.
-John Smith's wife greeted Robert Paulsen.
-Robert Paulsen greeted the two .
+Object value: string.
 ]]>
      </screen>
     </example>
 
+    <note>
+     <simpara>
+      数组键必须是无引号的，因此不能用基本语法将常量作为键来引用。使用
+      <link linkend="language.types.string.parsing.advanced">高级</link>
+      语法代替。
+     </simpara>
+    </note>
+
     <simpara>
      从 PHP 7.1.0 起，还支持<emphasis>负</emphasis>数字索引。
     </simpara>
 
     <example><title>负数索引</title>
      <programlisting role="php">
-      <![CDATA[
+<![CDATA[
 <?php
 $string = 'string';
 echo "The character at index -2 is $string[-2].", PHP_EOL;
@@ -763,7 +841,7 @@ echo "Changing the character at index -3 to o gives $string.", PHP_EOL;
      </programlisting>
      &example.outputs;
      <screen>
-      <![CDATA[
+<![CDATA[
 The character at index -2 is n.
 Changing the character at index -3 to o gives strong.
 ]]>
@@ -771,149 +849,96 @@ Changing the character at index -3 to o gives strong.
     </example>
 
     <simpara>
-     如果想要表达更复杂的结构，请用复杂语法。
+     对于更复杂的情况，可以使用 <link linkend="language.types.string.parsing.advanced">高级</link>
+     语法。
     </simpara>
    </sect4>
 
-   <sect4 xml:id="language.types.string.parsing.complex">
-    <title>复杂（花括号）语法</title>
+
+   <sect4 xml:id="language.types.string.parsing.advanced">
+    <title>高级（大括号）语法</title>
 
     <simpara>
-     复杂语法不是因为其语法复杂而得名，而是因为它可以使用复杂的表达式。
+     高级语法允许使用任意访问器对<emphasis>变量</emphasis>进行插值。
     </simpara>
 
     <simpara>
-     任何具有 <type>string</type>
-     表达的标量变量，数组单元或对象属性都可使用此语法。
-     表达式的书写方式与在 <type>string</type> 以外的方式相同，
-     然后用花括号 <literal>{</literal> 和 <literal>}</literal> 把它括起来即可。由于
-     <literal>{</literal> 无法被转义，只有 <literal>$</literal>
-     紧挨着 <literal>{</literal> 时才会被识别。可以用
-     <literal>{\$</literal> 来表达 <literal>{$</literal>。下面的示例可以更好的解释：
+     任何标量变量、数组元素或对象属性（<modifier>static</modifier> 或非
+     <modifier>static</modifier>）都可以通过这种语法进行插值。表达式的写法和
+     在<type>string</type>之外的写法一样，然后用大括号<literal>{</literal>和
+     <literal>}</literal>包围。由于<literal>{</literal>不能被转义，所以这种语法只有在
+     紧跟在<literal>{</literal>后面的<literal>$</literal>才会被识别。要得到一个字面的
+     <literal>{$</literal>，需要用<literal>{\$</literal>。以下是一些例子：
     </simpara>
 
     <informalexample>
      <programlisting role="php">
 <![CDATA[
 <?php
-// 显示所有错误
-error_reporting(E_ALL);
 
+const DATA_KEY = 'const-key';
 $great = 'fantastic';
-
-// 无效，输出：This is { fantastic}
+$arr = [
+    '1',
+    '2',
+    '3',
+    [41, 42, 43],
+    'key' => 'Indexed value',
+    'const-key' => 'Key with minus sign',
+    'foo' => ['foo1', 'foo2', 'foo3']
+];
+
+// Won't work, outputs: This is { fantastic}
 echo "This is { $great}";
 
-// 有效，输出： This is fantastic
+// Works, outputs: This is fantastic
 echo "This is {$great}";
 
-// 有效
-echo "This square is {$square->width}00 centimeters broad.";
+class Square {
+    public $width;
 
-// 有效，只有通过花括号语法才能正确解析带引号的键名
-echo "This works: {$arr['key']}";
+    public function __construct(int $width) { $this->width = $width; }
+}
+
+$square = new Square(5);
 
-// 有效
-echo "This works: {$arr[4][3]}";
+// Works
+echo "This square is {$square->width}00 centimeters wide.";
 
-// 这是错误的表达式，因为就象 $foo[bar] 的格式在字符串以外也是错的一样。
-// PHP 首先会查找名为 foo 的常量，如果没有找到，就会出错。
-// 如果常量被找到，其值（而不是 "foo" 本身）将用于数组索引。
 
-echo "This is wrong: {$arr[foo][3]}";
+// Works, quoted keys only work using the curly brace syntax
+echo "This works: {$arr['key']}";
 
-// 有效，当在字符串中使用多重数组时，一定要用括号将它括起来
-echo "This works: {$arr['foo'][3]}";
 
-// 有效
-echo "This works: " . $arr['foo'][3];
+// Works
+echo "This works: {$arr[3][2]}";
 
-echo "This works too: {$obj->values[3]->name}";
+echo "This works: {$arr[DATA_KEY]}";
 
-echo "This is the value of the var named $name: {${$name}}";
+// When using multidimensional arrays, always use braces around arrays
+// when inside of strings
+echo "This works: {$arr['foo'][2]}";
 
-echo "This is the value of the var named by the return value of getName(): {${getName()}}";
+echo "This works: {$obj->values[3]->name}";
 
-echo "This is the value of the var named by the return value of \$object->getName(): {${$object->getName()}}";
+echo "This works: {$obj->$staticProp}";
 
-// 无效，输出： This is the return value of getName(): {getName()}
-echo "This is the return value of getName(): {getName()}";
+// Won't work, outputs: C:\folder\{fantastic}.txt
+echo "C:\folder\{$great}.txt";
 
-// 无效, 输出： C:\folder\{fantastic}.txt
-echo "C:\folder\{$great}.txt"
-// 有效, 输出： C:\folder\fantastic.txt
-echo "C:\\folder\\{$great}.txt"
+// Works, outputs: C:\folder\fantastic.txt
+echo "C:\\folder\\{$great}.txt";
 ?>
 ]]>
-<!-- maybe it's better to leave this out??
-// this works, but i disencourage its use, since this is NOT
-// involving functions, rather than mere variables, arrays and objects.
-$beer = 'Heineken';
-echo "I'd like to have another {${ strrev('reeb') }}, hips";
- -->
      </programlisting>
     </informalexample>
 
-    <para>
-     也可以在字符串中用此语法通过变量来调用类的属性。
-    </para>
-
-   <informalexample>
-    <programlisting role="php">
-<![CDATA[
-<?php
-class foo {
-    var $bar = 'I am bar.';
-}
-
-$foo = new foo();
-$bar = 'bar';
-$baz = array('foo', 'bar', 'baz', 'quux');
-echo "{$foo->$bar}\n";
-echo "{$foo->{$baz[1]}}\n";
-?>
-]]>
-    </programlisting>
-   &example.outputs;
-   <screen>
-I am bar.
-I am bar.
-   </screen>
-   </informalexample>
-
     <note>
-     <para>
-      函数、方法、静态类变量和类常量可使用 <literal>{$}</literal>
-      ，在该字符串被定义的命名空间中将其值作为变量名来访问。只单一使用花括号
-      (<literal>{}</literal>) 无法处理从函数或方法的返回值或者类常量以及类静态变量的值。
-     </para>
+     <simpara>
+      由于该语法允许任意表达式，因此可以在高级语法中使用
+      <link linkend="language.variables.variable">可变变量</link>。
+     </simpara>
     </note>
-
-    <informalexample>
-     <programlisting role="php">
-<![CDATA[
-<?php
-// 显示所有错误
-error_reporting(E_ALL);
-
-class beers {
-    const softdrink = 'rootbeer';
-    public static $ale = 'ipa';
-}
-
-$rootbeer = 'A & W';
-$ipa = 'Alexander Keith\'s';
-
-// 有效，输出： I'd like an A & W
-echo "I'd like an {${beers::softdrink}}\n";
-
-// 也有效，输出： I'd like an Alexander Keith's
-echo "I'd like an {${beers::$ale}}\n";
-?>
-]]>
-     </programlisting>
-    </informalexample>
-
    </sect4>
   </sect3>
   
diff --git a/reference/filesystem/functions/glob.xml b/reference/filesystem/functions/glob.xml
index 3c93c4e73..63e9eba79 100644
--- a/reference/filesystem/functions/glob.xml
+++ b/reference/filesystem/functions/glob.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 850ac483c876e767048222f9133e2498145f9f4a Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: 07e4b982a4097d894d8576ab793f3cf18759983d Maintainer: HonestQiao Status: ready -->
 <!-- CREDITS: Luffy, mowangjuanzi -->
 <refentry xml:id="function.glob" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
@@ -68,7 +68,7 @@
       <para>
        有效标记有：
        <variablelist>
-        <xi:include set-xml-id="" xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('constant.glob-constant-variablelist')/*)"><xi:fallback/></xi:include>
+        <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('constant.glob-constant-variablelist')/*)"><xi:fallback/></xi:include>
        </variablelist>
       </para>
      </listitem>
diff --git a/reference/memcache/memcache/delete.xml b/reference/memcache/memcache/delete.xml
index 8bb547d1c..ce739047e 100644
--- a/reference/memcache/memcache/delete.xml
+++ b/reference/memcache/memcache/delete.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 756e0dd85815e12bc06b3b087b8f5319482bc088 Maintainer: HonestQiao Status: ready -->
-<!-- CREDITS: mowangjuanzi -->
+<!-- EN-Revision: c6b1157e3a7d906f3fa0f2836ff52aa2786806fa Maintainer: HonestQiao Status: ready -->
+<!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="memcache.delete" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>Memcache::delete</refname>
@@ -13,7 +13,7 @@
   <methodsynopsis>
    <type>bool</type><methodname>Memcache::delete</methodname>
    <methodparam><type>string</type><parameter>key</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>exptime</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
 
   <para>
@@ -35,7 +35,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>timeout</parameter></term>
+     <term><parameter>exptime</parameter></term>
      <listitem>
       <para>
        不支持此弃用参数，并且默认为 <literal>0</literal> 秒。不要使用此参数。
@@ -59,11 +59,10 @@
     </thead>
     <tbody>
      <row>
-      <entry>Unknown</entry>
+      <entry>PECL memcache 3.0.5</entry>
       <entry>
-       <!-- @todo I don't understand this topic; it could be documented better -->
-       不建议使用 <parameter>timeout</parameter> 参数。此行为在多个 memcached 版本之间的行为不同，但设置为 <literal>0</literal>
-       是安全的。此弃用功能的其他值可能会导致内存缓存删除失败。
+       <parameter>exptime</parameter> 已经被弃用，不应该再提供。
+       除了 <literal>0</literal> 之外的值可能会导致意外错误。
       </entry>
      </row>
     </tbody>
diff --git a/reference/outcontrol/constants.xml b/reference/outcontrol/constants.xml
index f8d1d8470..129be7493 100644
--- a/reference/outcontrol/constants.xml
+++ b/reference/outcontrol/constants.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7976e4688f783f37c8a90f59ac8f9a365d179160 Maintainer: mowangjuanzi Status: ready -->
+<!-- EN-Revision: 2a8768782512db2b95e5da2f032dd0347806d203 Maintainer: mowangjuanzi Status: ready -->
 <!-- CREDITS: Luffy -->
 <appendix xml:id="outcontrol.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.constants;
@@ -173,8 +173,9 @@
    </term>
    <listitem>
     <para>
-     表示输出处理程序已禁用。当输出处理程序返回 &false; 或者处理缓冲区失败时设置此
-     flag，也有一个情况就是在调用输出处理程序之前设置了此 flag。
+     表示输出处理程序已禁用。当输出处理程序返回 &false; 
+     或者处理缓冲区失败时设置此 flag。
+     在 PHP 8.4.0 之前，此 flag 可以在启动输出缓冲区时设置。
     </para>
    </listitem>
   </varlistentry>
diff --git a/reference/outcontrol/user-level-output-buffers.xml b/reference/outcontrol/user-level-output-buffers.xml
index 890fc695c..a3fac39af 100644
--- a/reference/outcontrol/user-level-output-buffers.xml
+++ b/reference/outcontrol/user-level-output-buffers.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7ad99aeafea66a1562f668aa3cb11dcc9d9cb951 Maintainer: mowangjuanzi Status: partial -->
+<!-- EN-Revision: 2a8768782512db2b95e5da2f032dd0347806d203 Maintainer: mowangjuanzi Status: partial -->
+<!-- CREDITS: Luffy -->
 <chapter xml:id="outcontrol.user-level-output-buffers" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>用户级别输出缓冲区</title>
  <para>
@@ -368,9 +369,11 @@
     If the <constant>PHP_OUTPUT_HANDLER_DISABLED</constant> of a handler is set,
     the handler will not be invoked by calling
     <function>ob_end_clean</function>, <function>ob_end_flush</function>,
-    <function>ob_get_clean</function>, <function>ob_get_flush</function>
+    <function>ob_get_clean</function>, <function>ob_get_flush</function>,
+    <function>ob_clean</function>,
+    <function>ob_flush</function>
     or during PHP's shutdown process.
-    This flag has no effect on when calling <function>ob_clean</function>
+    Prior to PHP 8.4.0, this flag had no effect when calling <function>ob_clean</function>
     or <function>ob_flush</function>.
    </simpara>
   </note>
@@ -575,9 +578,11 @@
     If the <constant>PHP_OUTPUT_HANDLER_DISABLED</constant> of a handler is set,
     the handler will not be invoked by calling
     <function>ob_end_clean</function>, <function>ob_end_flush</function>,
-    <function>ob_get_clean</function>, <function>ob_get_flush</function>
+    <function>ob_get_clean</function>, <function>ob_get_flush</function>,
+    <function>ob_clean</function>,
+    <function>ob_flush</function>
     or during PHP's shutdown process.
-    This flag has no effect on when calling <function>ob_clean</function>
+    Prior to PHP 8.4.0, this flag had no effect when calling <function>ob_clean</function>
     or <function>ob_flush</function>.
    </simpara>
   </note>