Skip to content

Commit 230b576

Browse files
sy-recordssy-records
authored
Sync outdated files (#919)
1 parent 5fada72 commit 230b576

File tree

14 files changed

+51
-60
lines changed

14 files changed

+51
-60
lines changed

‎features/gc.xml‎

Lines changed: 3 additions & 3 deletions
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: 9957fc259b7b920269ead2a0180969db5bf13433 Maintainer: mowangjuanzi Status: ready -->
3+
<!-- EN-Revision: 23e84882d6654f995166d17e5610af6bf00ef18c Maintainer: mowangjuanzi Status: ready -->
44
<!-- CREDITS: Luffy -->
55
<chapter xml:id="features.gc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>垃圾回收</title>
@@ -220,7 +220,7 @@ a: (refcount=1, is_ref=0)=array (
220220
</para>
221221
<para>
222222
<example>
223-
<title>将数组本身作为其自身的一个元素添加进去</title>
223+
<title>将数组添加为自身的一个元素</title>
224224
<programlisting role="php">
225225
<![CDATA[
226226
<?php
@@ -283,7 +283,7 @@ a: (refcount=2, is_ref=1)=array (
283283
<para>
284284
虽然在任何作用域中都没有指向这个结构的符号，却无法清理它，因为数组元素“1”仍然指向同一个数组。由于没有外部符号指向它，用户无法清理该结构；因此会出现内存泄漏。幸运的是，PHP
285285
会在请求结束时清理这个数据结构，但在此之前，它会占用宝贵的内存空间。如果你正在实现解析算法或其他需要子级元素指向"父级"元素的情况，会经常发生。当然，object
286-
也可能出现相同的情况，因为 object 始终隐式引用。
286+
也可能出现相同的情况，因为 object 始终隐式“<link linkend="language.oop5.references">引用</link>”。
287287
</para>
288288
<para>
289289
如果这种情况只发生一两次，可能不是问题，但如果出现数千次，甚至数百万次的内存损失，显然就成了问题。这在长时间运行的脚本中尤为棘手，比如守护进程，其中请求基本上永远不会结束，或者在大量的单元测试集中。后者在运行

‎install/cloud/azure.xml‎

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 5d591c30aeef70c8cd325ab914c102333cc9bd8f Maintainer: mowangjuanzi Status: ready -->
4-
5-
<sect1 xml:id="install.cloud.azure" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
3+
<!-- EN-Revision: 2dbf3d9064d4cb07f0a2f7d06641c877a2e5ed24 Maintainer: mowangjuanzi Status: ready -->
4+
<!-- CREDITS: Luffy -->
5+
<sect1 xml:id="install.cloud.azure" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>Azure 应用服务</title>
77
<para>
88
PHP 经常用于 Azure 应用服务（又称 Microsoft Azure、Windows Azure、Azure Web 应用）。
@@ -15,8 +15,6 @@
1515

1616
<para>因此，PHP 和扩展将跟在其他 Windows 服务器一样在 Azure 应用服务上运行。
1717

18-
大部分的知识库也适用，因此也可以参阅 <link linkend="install.windows.troubleshooting">Windows 疑难解答页面</link>。
19-
2018
然而，Azure 应用管理的管理界面是不同的：
2119
</para>
2220

@@ -54,7 +52,7 @@
5452
</para>
5553
</sect2>
5654

57-
</sect1>
55+
</sect1>
5856

5957
<!-- Keep this comment at the end of the file
6058
Local variables:

‎install/windows/building.xml‎

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,12 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 53afbdaf791ddbc4455672122573644f3f0d7949 Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: 2dbf3d9064d4cb07f0a2f7d06641c877a2e5ed24 Maintainer: HonestQiao Status: ready -->
44
<!-- CREDITS: Luffy -->
55
<sect1 xml:id="install.windows.building" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>从源程序编译</title>
7-
<para>
8-
本章讲述了在 Windows 下如何使用 Microsoft 的工具编译 PHP。要在
9-
CygWin 中编译 PHP，请参考 <xref linkend="install.unix"/> 一章。
10-
</para>
11-
<para>
12-
具体内容见：<link xlink:href="&url.wiki.windows.build.howto;">&url.wiki.windows.build.howto;</link>。
13-
</para>
7+
<simpara>
8+
参阅 <link xlink:href="&url.install.windows.stepbystep;">逐步构建说明</link> 以使用 Visual Studio 进行编译。
9+
</simpara>
1410
</sect1>
1511

1612
<!-- Keep this comment at the end of the file

‎language-snippets.ent‎

Lines changed: 3 additions & 3 deletions
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: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: Gregory Status: ready -->
3+
<!-- EN-Revision: 27aaf9a626b5711866a2e6957f568e3c31143760 Maintainer: Gregory Status: ready -->
44
<!-- CREDITS: dallas, mowangjuanzi, Luffy -->
55
<!-- 请保持此文件与英文文件中相应的每个 ENTITY 行号一一对应以便于对照，修改与更新！ -->
66

@@ -3521,7 +3521,7 @@ local: {
35213521
<row>
35223522
<entry>sparsity</entry>
35233523
<entry><type>int</type></entry>
3524-
<entry>Required. Positive 64-bit integer.</entry>
3524+
<entry>Optional. Positive 64-bit integer.</entry>
35253525
</row>
35263526
<row>
35273527
<entry>precision</entry>
@@ -3535,7 +3535,7 @@ local: {
35353535
<row>
35363536
<entry>trimFactor</entry>
35373537
<entry><type>int</type></entry>
3538-
<entry>Required. Positive 32-bit integer.</entry>
3538+
<entry>Optional. Positive 32-bit integer.</entry>
35393539
</row>
35403540
</tbody>
35413541
</tgroup>

‎language/control-structures/declare.xml‎

Lines changed: 15 additions & 15 deletions
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: 28529d3539b850e870e3aa97570f4db0e53daa03 Maintainer: dallas Status: ready -->
3+
<!-- EN-Revision: 5499acf9df7e1338d540bde207acc859792cd139 Maintainer: dallas Status: ready -->
44
<!-- CREDITS: Luffy -->
55
<sect1 xml:id="control-structures.declare" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>declare</title>
@@ -19,20 +19,20 @@ declare (directive)
1919
</para>
2020
<para>
2121
<literal>directive</literal> 部分允许设定 <literal>declare</literal>
22-
代码段的行为。目前只认识三个指令：<literal>ticks</literal>（更多信息见下面
23-
<link linkend="control-structures.declare.ticks">ticks</link> 指令）、
24-
<literal>encoding</literal>（更多信息见下面 <link
25-
linkend="control-structures.declare.encoding">encoding</link> 指令）、
26-
<literal>strict_types</literal> 指令 (更多信息见类型声明页面
27-
<link linkend="language.types.declarations.strict">严格类型</link>
28-
章节)。
22+
代码段的行为。
23+
目前只认识三个指令：
24+
<simplelist>
25+
<member><link linkend="control-structures.declare.ticks"><literal>ticks</literal></link></member>
26+
<member><link linkend="control-structures.declare.encoding"><literal>encoding</literal></link></member>
27+
<member><link linkend="language.types.declarations.strict"><literal>strict_types</literal></link></member>
28+
</simplelist>
2929
</para>
3030
<para>
31-
因为本指令是在文件编译时处理的，所以指令只接受字面量的值。
32-
无法使用变量和常量。下面为你演示：
33-
<informalexample>
34-
<programlisting role="php">
35-
<![CDATA[
31+
因为本指令是在文件编译时处理的，所以指令只接受字面量的值。
32+
无法使用变量和常量。下面为你演示：
33+
<informalexample>
34+
<programlisting role="php">
35+
<![CDATA[
3636
<?php
3737
// 这样是有效的：
3838
declare(ticks=1);
@@ -42,8 +42,8 @@ const TICK_VALUE = 1;
4242
declare(ticks=TICK_VALUE);
4343
?>
4444
]]>
45-
</programlisting>
46-
</informalexample>
45+
</programlisting>
46+
</informalexample>
4747
</para>
4848
<para>
4949
<literal>declare</literal> 代码段中的 <literal>statement</literal>

‎language/control-structures/include-once.xml‎

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,14 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- $Author$ -->
4-
<!-- Reviewed: yes Maintainer: dallas -->
5-
<!-- EN-Revision: af6fdf16ab44bcf4d045407963e43c3d9dd2ff29 Maintainer: dallas Status: ready -->
6-
3+
<!-- EN-Revision: 89d80c92a1154a2903fff371f0d056bf2ac8ba27 Maintainer: dallas Status: ready -->
4+
<!-- CREDITS: Luffy -->
75
<sect1 xml:id="function.include-once" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
86
<title>include_once</title>
97
<?phpdoc print-version-for="include_once"?>
108
<para>
11-
<literal>include_once</literal> 语句在脚本执行期间包含并运行指定文件。此行为和
12-
<function>include</function>
13-
语句类似，唯一区别是如果该文件中已经被包含过，则不会再次包含，且 include_once 会返回 &true;。
9+
<literal>include_once</literal> 表达在脚本执行期间包含并运行指定文件。此行为和
10+
<function>include</function> 表达类似，
11+
唯一区别是如果该文件中已经被包含过，则不会再次包含，且 include_once 会返回 &true;。
1412
顾名思义，require_once，文件仅仅包含（require）一次。
1513
</para>
1614
<para>

‎language/enumerations.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 0f53e8f37b7bf8513c93e5e2d67e7787f26ed693 Maintainer: daijie Status: ready -->
2+
<!-- EN-Revision: 83e2056f071742c44d2b0bdbc8574d73697c7a08 Maintainer: daijie Status: ready -->
33
<!-- CREDITS: Luffy, mowangjuanzi -->
44
<chapter xml:id="language.enumerations" xmlns="http://docbook.org/ns/docbook">
55
<title>枚举</title>

‎language/functions.xml‎

Lines changed: 2 additions & 2 deletions
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: f94d903985119d3ac00f4528551df947f57b667f Maintainer: avenger Status: ready -->
3+
<!-- EN-Revision: 74976cdb263ef841c5fc2c3f91ca7e284adce552 Maintainer: avenger Status: ready -->
44
<!-- CREDITS: Gregory, dallas, Luffy, mowangjuanzi -->
55
<chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook">
66
<title>函数</title>
@@ -1397,7 +1397,7 @@ var_export($fn(5)(10));
13971397
<?php
13981398
13991399
fn(array $x) => $x;
1400-
static fn(): int => $x;
1400+
static fn($x): int => $x;
14011401
fn($x = 42) => $x;
14021402
fn(&$x) => $x;
14031403
fn&($x) => $x;

‎language/operators/comparison.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: mowangjuanzi Status: ready -->
2+
<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: mowangjuanzi Status: ready -->
33
<!-- CREDITS: Luffy -->
44
<sect1 xml:id="language.operators.comparison">
55
<title>比较运算符</title>

‎language/wrappers/php.xml‎

Lines changed: 2 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: bad50150f7e06228f48c4461fab52afe08a4d5e4 Maintainer: daijie Status: ready -->
3+
<!-- EN-Revision: 0592e6316d3869b49637df29c471097e7bf78592 Maintainer: daijie Status: ready -->
44
<!-- CREDITS: Luffy, mowangjuanzi -->
55
<refentry xml:id="wrappers.php" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
66
<refnamediv>
@@ -332,6 +332,7 @@ file_put_contents("php://filter/write=string.rot13/resource=example.txt","Hello
332332
</para>
333333
<programlisting role="php">
334334
<![CDATA[
335+
<?php
335336
file_put_contents('php://memory', 'PHP');
336337
echo file_get_contents('php://memory'); // 啥也没有
337338
]]>

0 commit comments

Comments
 (0)