Skip to content

Commit 35ae04f

Browse files
sy-recordssy-records
authored
Sync skip files (#946)
1 parent cca949e commit 35ae04f

File tree

9 files changed

+188
-31
lines changed

9 files changed

+188
-31
lines changed

‎appendices/filters.xml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: da4977f316e4a05be800e865b979c10d19436112 Maintainer: mowangjuanzi Status: ready -->
3+
<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: mowangjuanzi Status: ready -->
4+
<!-- CREDITS: Luffy -->
45
<appendix xml:id="filters" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<title>可用过滤器列表</title>
67
<para>
@@ -253,7 +254,7 @@ fclose($fp);
253254
<parameter>window</parameter>是压缩回溯窗口大小，以二的次方表示。
254255
更高的值（大到 15 —— 32768 字节）产生更好的压缩效果但消耗更多内存，
255256
低的值（低到 9 —— 512 字节）产生产生较差的压缩效果但内存消耗低。
256-
目前默认的 <parameter>window</parameter> 大小是 <constant>15</constant>。
257+
目前默认的 <parameter>window</parameter> 大小是 <literal>15</literal>。
257258

258259
<parameter>memory</parameter>用来指示要分配多少工作内存。
259260
合法的数值范围是从 1（最小分配）到 9（最大分配）。

‎language/predefined/interfaces.xml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: ce78d59569fcae6286c46abe1b781a0b6fc594c0 Maintainer: HonestQiao Status: ready -->
4-
<!-- CREDITS: mowangjuanzi -->
3+
<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: HonestQiao Status: ready -->
4+
<!-- CREDITS: mowangjuanzi, Luffy -->
55
<part xml:id="reserved.interfaces" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>预定义接口和类</title>
77

@@ -29,6 +29,7 @@
2929
&language.predefined.unitenum;
3030
&language.predefined.backedenum;
3131
&language.predefined.sensitiveparametervalue;
32+
&language.predefined.php-incomplete-class;
3233

3334
</part>
3435

‎language/predefined/php-incomplete-class.xml

Lines changed: 147 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,147 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: c0e48705eb88453af785e0e4a6cbd526085dfe3a Maintainer: Luffy Status: ready -->
4+
<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">
5+
6+
<title>__PHP_Incomplete_Class 类</title>
7+
<titleabbrev>__PHP_Incomplete_Class</titleabbrev>
8+
9+
<partintro>
10+
11+
<section xml:id="php-incomplete-class.intro">
12+
&reftitle.intro;
13+
<para>
14+
由 <function>unserialize</function> 创建的在尝试反序列化未定义类或未在 <function>unserialize</function>
15+
的 <parameter>options</parameter> 数组的 <literal>allowed_classes</literal>
16+
中列出的类。
17+
</para>
18+
19+
<para>
20+
在 PHP 7.2.0 之前，对 <classname>__PHP_Incomplete_Class</classname> 类使用 <function>is_object</function>
21+
会返回 &false;。从 PHP 7.2.0 开始，将返回 &true;。
22+
</para>
23+
</section>
24+
25+
<section xml:id="php-incomplete-class.synopsis">
26+
&reftitle.classsynopsis;
27+
28+
<classsynopsis class="class">
29+
<ooclass>
30+
<modifier>final</modifier>
31+
<classname>__PHP_Incomplete_Class</classname>
32+
</ooclass>
33+
</classsynopsis>
34+
35+
<para>
36+
此类没有默认属性或方法。
37+
由 <function>unserialize</function> 创建时，
38+
除了所有反序列化的属性和值之外，
39+
对象还将具有一个 <literal>__PHP_Incomplete_Class_Name</literal> 属性，
40+
该属性将包含反序列化类的名称。
41+
</para>
42+
</section>
43+
44+
<section xml:id="php-incomplete-class.changelog" role="changelog">
45+
&reftitle.changelog;
46+
<informaltable>
47+
<tgroup cols="2">
48+
<thead>
49+
<row>
50+
<entry>&Version;</entry>
51+
<entry>&Description;</entry>
52+
</row>
53+
</thead>
54+
<tbody>
55+
<row>
56+
<entry>8.0.0</entry>
57+
<entry>
58+
此类现在是 <literal>final</literal>。
59+
</entry>
60+
</row>
61+
</tbody>
62+
</tgroup>
63+
</informaltable>
64+
</section>
65+
66+
<section xml:id="php-incomplete-class.examples" role="examples">
67+
&reftitle.examples;
68+
<example xml:id="php-incomplete-class.basic-example">
69+
<title>由 <function>unserialize</function> 创建</title>
70+
<programlisting role="php">
71+
<![CDATA[
72+
<?php
73+
74+
class MyClass
75+
{
76+
public string $property = "myValue";
77+
}
78+
79+
$myObject = new MyClass;
80+
81+
$foo = serialize($myObject);
82+
83+
// unserializes all objects into __PHP_Incomplete_Class objects
84+
$disallowed = unserialize($foo, ["allowed_classes" => false]);
85+
86+
var_dump($disallowed);
87+
88+
// unserializes all objects into __PHP_Incomplete_Class objects except those of MyClass2 and MyClass3
89+
$disallowed2 = unserialize($foo, ["allowed_classes" => ["MyClass2", "MyClass3"]]);
90+
91+
var_dump($disallowed2);
92+
93+
// unserializes undefined class into __PHP_Incomplete_Class object
94+
$undefinedClass = unserialize('O:16:"MyUndefinedClass":0:{}');
95+
96+
var_dump($undefinedClass);
97+
]]>
98+
</programlisting>
99+
&example.outputs;
100+
<screen>
101+
<![CDATA[
102+
103+
object(__PHP_Incomplete_Class)#2 (2) {
104+
["__PHP_Incomplete_Class_Name"]=>
105+
string(7) "MyClass"
106+
["property"]=>
107+
string(7) "myValue"
108+
}
109+
object(__PHP_Incomplete_Class)#3 (2) {
110+
["__PHP_Incomplete_Class_Name"]=>
111+
string(7) "MyClass"
112+
["property"]=>
113+
string(7) "myValue"
114+
}
115+
object(__PHP_Incomplete_Class)#4 (1) {
116+
["__PHP_Incomplete_Class_Name"]=>
117+
string(16) "MyUndefinedClass"
118+
}
119+
120+
]]>
121+
</screen>
122+
</example>
123+
</section>
124+
125+
</partintro>
126+
127+
</reference>
128+
<!-- Keep this comment at the end of the file
129+
Local variables:
130+
mode: sgml
131+
sgml-omittag:t
132+
sgml-shorttag:t
133+
sgml-minimize-attributes:nil
134+
sgml-always-quote-attributes:t
135+
sgml-indent-step:1
136+
sgml-indent-data:t
137+
indent-tabs-mode:nil
138+
sgml-parent-document:nil
139+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
140+
sgml-exposed-tags:nil
141+
sgml-local-catalogs:nil
142+
sgml-local-ecat-files:nil
143+
End:
144+
vim600: syn=xml fen fdm=syntax fdl=2 si
145+
vim: et tw=78 syn=sgml
146+
vi: ts=1 sw=1
147+
-->

‎reference/event/eventconfig/setmaxdispatchinterval.xml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- $Author: Avenger $ -->
4-
<!-- EN-Revision: da9d81816187b87c03a6cd92a3c3b833f039485c Maintainer: mowangjuanzi Status: ready -->
3+
<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: mowangjuanzi Status: ready -->
4+
<!-- CREDITS: Luffy -->
55
<refentry xml:id="eventconfig.setmaxdispatchinterval" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<refnamediv>
77
<refname>EventConfig::setMaxDispatchInterval</refname>
@@ -47,7 +47,7 @@
4747
<listitem>
4848
<para>
4949
Libevent 应该停止运行回调并检查更多时间的间隔，如果为
50-
<constant>0</constant>，则没有这样的间隔。
50+
<literal>0</literal>，则没有这样的间隔。
5151
</para>
5252
</listitem>
5353
</varlistentry>
@@ -70,9 +70,9 @@
7070
<para>
7171
不应执行低于 <parameter>max_interval</parameter> 和
7272
<parameter>max_callbacks</parameter> 优先级的事件。如果设置为
73-
<constant>0</constant>，它适用于每个优先级事件；如果设置为
74-
<constant>1</constant>，它适用于优先级在
75-
<constant>1</constant>及其以上的事件，以此类推。
73+
<literal>0</literal>，它适用于每个优先级事件；如果设置为
74+
<literal>1</literal>，它适用于优先级在
75+
<literal>1</literal>及其以上的事件，以此类推。
7676
</para>
7777
</listitem>
7878
</varlistentry>

‎reference/filesystem/functions/stat.xml

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 1f7d8b1ee9e6c7350857ddc8bfce248a65a29787 Maintainer: HonestQiao Status: ready -->
4-
<!-- CREDITS: mowangjuanzi -->
3+
<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: HonestQiao Status: ready -->
4+
<!-- CREDITS: mowangjuanzi, Luffy -->
55
<refentry xml:id="function.stat" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
77
<refname>stat</refname>
@@ -162,37 +162,37 @@
162162
</thead>
163163
<tbody>
164164
<row>
165-
<entry><constant>0140000</constant></entry>
165+
<entry><literal>0140000</literal></entry>
166166
<entry>socket</entry>
167167
</row>
168168
<row>
169-
<entry><constant>0120000</constant></entry>
169+
<entry><literal>0120000</literal></entry>
170170
<entry>link</entry>
171171
</row>
172172
<row>
173-
<entry><constant>0100000</constant></entry>
173+
<entry><literal>0100000</literal></entry>
174174
<entry>常规文件</entry>
175175
</row>
176176
<row>
177-
<entry><constant>0060000</constant></entry>
177+
<entry><literal>0060000</literal></entry>
178178
<entry>块设备</entry>
179179
</row>
180180
<row>
181-
<entry><constant>0040000</constant></entry>
181+
<entry><literal>0040000</literal></entry>
182182
<entry>目录</entry>
183183
</row>
184184
<row>
185-
<entry><constant>0020000</constant></entry>
185+
<entry><literal>0020000</literal></entry>
186186
<entry>字符设备</entry>
187187
</row>
188188
<row>
189-
<entry><constant>0010000</constant></entry>
189+
<entry><literal>0010000</literal></entry>
190190
<entry>fifo</entry>
191191
</row>
192192
</tbody>
193193
</tgroup>
194194
</table>
195-
例如普通文件可能是 <constant>0100644</constant>，目录可能是 <constant>0040755</constant>。
195+
例如普通文件可能是 <literal>0100644</literal>，目录可能是 <literal>0040755</literal>。
196196
</para>
197197
<para>
198198
如果出错，<function>stat</function> 返回 &false;。

‎reference/mcrypt/constants.xml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: yuanyuqiang Status: ready -->
4-
<!-- CREDITS: mowangjuanzi -->
3+
<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: yuanyuqiang Status: ready -->
4+
<!-- CREDITS: mowangjuanzi, Luffy -->
55
<appendix xml:id="mcrypt.constants" xmlns="http://docbook.org/ns/docbook">
66
&reftitle.constants;
77
&extension.constants;
@@ -67,12 +67,12 @@
6767
<itemizedlist>
6868
<listitem>
6969
<simpara>
70-
<constant>"ctr"</constant> (<literal>counter mode</literal>) 是一种流式加密模式。
70+
<literal>"ctr"</literal> (<literal>counter mode</literal>) 是一种流式加密模式。
7171
</simpara>
7272
</listitem>
7373
<listitem>
7474
<simpara>
75-
<constant>"ncfb"</constant> (<literal>cipher feedback,
75+
<literal>"ncfb"</literal> (<literal>cipher feedback,
7676
in n-bit mode</literal>)，类似于 <literal>CFB</literal> 模式，
7777
但是它会对于算法设定的整块数据进行操作。
7878
</simpara>

‎reference/oci8/functions/oci-set-prefetch.xml

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

‎reference/sockets/functions/socket-read.xml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 14dc7c47365f2b71f6c907a5ba5bccf42534d5a9 Maintainer: her-cat Status: ready -->
3+
<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: her-cat Status: ready -->
4+
<!-- CREDITS: Luffy -->
45
<refentry xml:id="function.socket-read" xmlns="http://docbook.org/ns/docbook">
56
<refnamediv>
67
<refname>socket_read</refname>
@@ -41,7 +42,7 @@
4142
<listitem>
4243
<para>
4344
<parameter>length</parameter> 参数指定了最大能够读取的字节数。否则您可以使用
44-
<constant>\r</constant>、<constant>\n</constant>、<constant>\0</constant>
45+
<literal>\r</literal>、<literal>\n</literal>、<literal>\0</literal>
4546
结束读取（根据 <parameter>mode</parameter> 参数设置，请参见下文）。
4647
</para>
4748
</listitem>

‎reference/var/functions/unserialize.xml

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 4150dc92749c177758efe59eab23b6a5d32ffda2 Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: HonestQiao Status: ready -->
44
<!-- CREDITS: mowangjuanzi, Luffy -->
55
<refentry xml:id="function.unserialize" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -141,6 +141,12 @@
141141
</row>
142142
</thead>
143143
<tbody>
144+
<row>
145+
<entry>8.3.0</entry>
146+
<entry>
147+
当传递的字符串有未消耗的数据时，现在会发出 <constant>E_WARNING</constant>。
148+
</entry>
149+
</row>
144150
<row>
145151
<entry>8.3.0</entry>
146152
<entry>

0 commit comments

Comments
 (0)