Update var

mowangjuanzi · mowangjuanzi · commit 160259f2a3b2 · 2025-01-13T00:03:38.000+08:00
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,3 @@
+{
+    "workbench.sash.size": 1
+}
diff --git a/reference/var/functions/empty.xml b/reference/var/functions/empty.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9b68bf2b63200534e022bc65e800cae6c75abf26 Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: 4a07033f7ac5ab121357051cc94ec48b9f6f58fc Maintainer: HonestQiao Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.empty" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
diff --git a/reference/var/functions/is-callable.xml b/reference/var/functions/is-callable.xml
@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 83a17a7324c2597bd6385148abf19f76127229f5 Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: 32c55286c8739fd20de9c8624473b2f3268de68e Maintainer: HonestQiao Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <refentry xml:id="function.is-callable" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>is_callable</refname>
   <refpurpose>
-   验证值是否可以在当前范围内作为函数调用。
+   验证值是否可以在当前范围内作为函数调用
   </refpurpose>
  </refnamediv>
 
@@ -19,7 +19,8 @@
    <methodparam choice="opt"><type>string</type><parameter role="reference">callable_name</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   验证值是 <type>callable</type>。
+   验证 <parameter>value</parameter> 是 <type>callable</type>，或者其可以使用
+   <function>call_user_func</function> 函数调用。
   </para>
  </refsect1>
 
@@ -31,7 +32,7 @@
      <term><parameter>value</parameter></term>
      <listitem>
       <para>
-       要验证的值
+       要验证的值。
       </para>
      </listitem>
     </varlistentry>
@@ -40,17 +41,18 @@
      <listitem>
       <para>
        如果设置为 &true;，则函数仅验证 <parameter>value</parameter>
-       可能是函数或方法。它仅拒绝不是字符串的简单变量，或者不能用作回调的有效结构的数组。只有
-       2 个条目有效，一个是对象或者字符串，其次是字符串。
+       是函数还是方法。它将拒绝任何不是<link linkend="object.invoke">可调用</link>对象、<classname>Closure</classname>、&string;
+       或者不能用作回调的无效结构的数组的值。有效的可调用数组只有
+       2 个条目，第一个是对象或者字符串，第二个是字符串。
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>callable_name</parameter></term>
      <listitem>
       <para>
-       接受“可调用的名称”。下面的例子是“someClass::someMethod”。注意，尽管 
-       someClass::SomeMethod() 暗示是可调用的静态方法，但事实并非如此。
+       接受 “callable 名称”，例如 <literal>"SomeClass::someMethod"</literal>。注意，尽管 
+       <literal>SomeClass::someMethod()</literal> 暗示是可调用静态方法，但事实并非如此。
       </para>
      </listitem>
     </varlistentry>
@@ -69,54 +71,66 @@
   &reftitle.examples;
   <para>
    <example>
-    <title><function>is_callable</function> 例子</title>
+    <title>检查字符串是否可以作为函数调用</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-//  如何检测变量以查看是否可以作为函数调用。
 
-//
-//  包含函数的简单变量
-//
-
-function someFunction() 
-{
-}
+function someFunction() {}
 
 $functionVariable = 'someFunction';
 
-var_dump(is_callable($functionVariable, false, $callable_name));  // bool(true)
-
-echo $callable_name, "\n";  // someFunction
+var_dump(is_callable($functionVariable, false, $callable_name));
 
-//
-//  包含方法的数组
-//
+var_dump($callable_name);
 
-class someClass {
-
-  function someMethod() 
-  {
-  }
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+bool(true)
+string(12) "someFunction"
+]]>
+    </screen>
+   </example>
+   <example>
+    <title>检查数组是否可以作为函数调用</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
 
+class SomeClass
+{
+    public function someMethod() {}
 }
 
-$anObject = new someClass();
+$anObject = new SomeClass();
 
-$methodVariable = array($anObject, 'someMethod');
+$methodVariable = [$anObject, 'someMethod'];
 
-var_dump(is_callable($methodVariable, true, $callable_name));  //  bool(true)
+var_dump(is_callable($methodVariable, true, $callable_name));
 
-echo $callable_name, "\n";  //  someClass::someMethod
+var_dump($callable_name);
 
 ?>
 ]]>
     </programlisting>
-   </example>   
+    &example.outputs;
+    <screen>
+<![CDATA[
+bool(true)
+string(21) "SomeClass::someMethod"
+]]>
+    </screen>
+   </example>
    <example>
-    <title><function>is_callable</function> 和构造函数</title>
+    <title><function>is_callable</function> 和构造方法</title>
     <simpara>
-     <function>is_callable</function> 报告构造函数不可调用。
+     尽管构造方法是创建对象时调用的方法，但它们不是静态方法，<function>is_callable</function>
+     将对它们返回 &false;。无法使用 <function>is_callable</function> 检查类是否可以从当前作用域实例化。
+
     </simpara>
     <programlisting role="php">
 <![CDATA[
@@ -125,20 +139,27 @@ echo $callable_name, "\n";  //  someClass::someMethod
 class Foo
 {
     public function __construct() {}
+
     public function foo() {}
 }
 
 var_dump(
-    is_callable(array('Foo', '__construct')),
-    is_callable(array('Foo', 'foo'))
+    is_callable(['Foo', '__construct']),
+    is_callable(['Foo', 'foo'])
 );
+
+$foo = new Foo();
+var_dump(is_callable([$foo, '__construct']));
+
+?>
 ]]>
     </programlisting>
     &example.outputs;
     <screen>
 <![CDATA[
 bool(false)
 bool(false)
+bool(true)
 ]]>
     </screen>
    </example>
@@ -168,6 +189,7 @@ bool(false)
   &reftitle.seealso;
   <para>
    <simplelist>
+    <member><function>call_user_func</function></member>
     <member><function>function_exists</function></member>
     <member><function>method_exists</function></member>
    </simplelist>
diff --git a/reference/var/functions/print-r.xml b/reference/var/functions/print-r.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: ccc438a27bae31d71fe2ca7dc095360db5bc1af6 Maintainer: nio Status: ready -->
+<!-- EN-Revision: 649598d5e2965b2565f7724cdb4fd4f094d4c81e Maintainer: nio Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <refentry xml:id="function.print-r" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>string</type><type>bool</type></type><methodname>print_r</methodname>
+   <type class="union"><type>string</type><type>true</type></type><methodname>print_r</methodname>
    <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
    <methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
@@ -62,11 +62,35 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        返回类型从 <type class="union"><type>string</type><type>bool</type></type> 变为 <type class="union"><type>string</type><type>true</type></type>。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
-    <title><function>print_r</function> 例子</title>
+    <title><function>print_r</function> 示例</title>
     <programlisting role="php">
 <![CDATA[
 <pre>
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: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: 42bb18bcfef4f715008d00bbdc7ea5203f8ec30a Maintainer: HonestQiao Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.unserialize" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -51,11 +51,13 @@
       </para>
       <para>
        <note>
-        <title><link linkend="ini.unserialize-callback-func">unserialize_callback_func</link> 指令</title>
-        <para>
+        <title>
          <link linkend="ini.unserialize-callback-func">unserialize_callback_func</link>
-         指令中指定的回调函数在反序列化未定义的类时会调用。如果没有指定回调函数，对象将被实例化为
-         <classname>__PHP_Incomplete_Class</classname>。
+          指令
+        </title>
+        <para>
+         在反序列化未定义类时会调用 <link linkend="ini.unserialize-callback-func">unserialize_callback_func</link>
+         指令中指定的回调。如果没有指定回调，将对象实例化为 <classname>__PHP_Incomplete_Class</classname>。
         </para>
        </note>
       </para>
@@ -80,7 +82,7 @@
         <tbody>
          <row>
           <entry><literal>allowed_classes</literal></entry>
-          <entry><type>mixed</type></entry>
+          <entry><type>array|bool</type></entry>
           <entry>
            <simpara>
             应该接受的类名数组，&false; 表示不接受任何类，或者 &true; 表示接受所有类。如果定义此选项且
@@ -124,9 +126,14 @@
 
  <refsect1 role="errors">
   &reftitle.errors;
-  <para>
+  <simpara>
    对象可能会在反序列化处理程序中抛出 <classname>Throwable</classname>。
-  </para>
+  </simpara>
+  <simpara>
+   自 PHP 8.4.0 起，如果 <parameter>options</parameter> 的 <literal>allowed_classes</literal>
+   元素不是类名 <type>array</type>，则 <function>unserialize</function> 会抛出 <exceptionname>TypeError</exceptionname>
+   和 <exceptionname>ValueError</exceptionname>。
+  </simpara>
  </refsect1>
 
  <refsect1 role="changelog">
@@ -141,6 +148,20 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        如果 <parameter>options</parameter> 的 <literal>allowed_classes</literal>
+        元素不是类名 <type>array</type>，现在会抛出 <exceptionname>TypeError</exceptionname>
+        和 <exceptionname>ValueError</exceptionname>。
+       </entry>
+      </row>
+      <row>
+       <entry>8.3.0</entry>
+       <entry>
+        当输入字符串有未使用的数据时，现在会发出 <constant>E_WARNING</constant>。
+       </entry>
+      </row>
       <row>
        <entry>8.3.0</entry>
        <entry>
@@ -178,7 +199,7 @@
   &reftitle.examples;
   <para>
    <example>
-    <title><function>unserialize</function> 例子</title>
+    <title><function>unserialize</function> 示例</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -206,7 +227,7 @@ if (!odbc_execute($stmt, $sqldata) || !odbc_fetch_into($stmt, $tmp)) {
   </para>
   <para>
    <example>
-    <title>unserialize_callback_func 例子</title>
+    <title>unserialize_callback_func 示例</title>
     <programlisting role="php">
 <![CDATA[
 <?php

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+{`
	`2`	`+ "workbench.sash.size": 1`
	`3`	`+}`