Skip to content

Commit

Permalink
Sync skip files (#946)
Browse files Browse the repository at this point in the history
  • Loading branch information
sy-records authored Dec 6, 2024
1 parent cca949e commit 35ae04f
Show file tree
Hide file tree
Showing 9 changed files with 188 additions and 31 deletions.
5 changes: 3 additions & 2 deletions appendices/filters.xml
Original file line number Diff line number Diff line change
@@ -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>
Expand Down Expand Up @@ -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(最大分配)。
Expand Down
5 changes: 3 additions & 2 deletions language/predefined/interfaces.xml
Original file line number Diff line number Diff line change
@@ -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>

Expand Down Expand Up @@ -29,6 +29,7 @@
&language.predefined.unitenum;
&language.predefined.backedenum;
&language.predefined.sensitiveparametervalue;
&language.predefined.php-incomplete-class;

</part>

Expand Down
147 changes: 147 additions & 0 deletions language/predefined/php-incomplete-class.xml
Original file line number Diff line number Diff line change
@@ -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
-->
12 changes: 6 additions & 6 deletions reference/event/eventconfig/setmaxdispatchinterval.xml
Original file line number Diff line number Diff line change
@@ -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>
Expand Down Expand Up @@ -47,7 +47,7 @@
<listitem>
<para>
Libevent 应该停止运行回调并检查更多时间的间隔,如果为
<constant>0</constant>,则没有这样的间隔。
<literal>0</literal>,则没有这样的间隔。
</para>
</listitem>
</varlistentry>
Expand All @@ -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>
Expand Down
20 changes: 10 additions & 10 deletions reference/filesystem/functions/stat.xml
Original file line number Diff line number Diff line change
@@ -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>
Expand Down Expand Up @@ -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;
Expand Down
8 changes: 4 additions & 4 deletions reference/mcrypt/constants.xml
Original file line number Diff line number Diff line change
@@ -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;
Expand Down Expand Up @@ -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>
Expand Down
9 changes: 5 additions & 4 deletions reference/oci8/functions/oci-set-prefetch.xml
Original file line number Diff line number Diff line change
@@ -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>
Expand Down Expand Up @@ -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">
Expand Down
5 changes: 3 additions & 2 deletions reference/sockets/functions/socket-read.xml
Original file line number Diff line number Diff line change
@@ -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>
Expand Down Expand Up @@ -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>
Expand Down
8 changes: 7 additions & 1 deletion reference/var/functions/unserialize.xml
Original file line number Diff line number Diff line change
@@ -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>
Expand Down Expand Up @@ -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>
Expand Down

0 comments on commit 35ae04f

Please sign in to comment.