Skip to content

Commit 7079ce7

Browse files
sy-recordssy-records
authored
Fix links to magic constants page (#982)
1 parent 21d40d6 commit 7079ce7

File tree

7 files changed

+50
-48
lines changed

7 files changed

+50
-48
lines changed

‎appendices/reserved.xml‎

Lines changed: 15 additions & 12 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: 010542d1dcb9b1d5cd397a77ed580e50de25aca7 Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: a124543dd3f6b1e5567b07420d23899e582514dc Maintainer: HonestQiao Status: ready -->
44
<!-- CREDITS: dallas, Luffy, mowangjuanzi -->
55
<appendix xml:id="reserved" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>保留字列表</title>
@@ -136,7 +136,7 @@
136136
<link linkend="control-structures.for">for</link>
137137
</entry>
138138
<entry>
139-
&foreach;
139+
<link linkend="control-structures.foreach">foreach</link>
140140
</entry>
141141
</row>
142142
<row>
@@ -243,7 +243,7 @@
243243
</row>
244244
<row>
245245
<entry>
246-
<link linkend="language.namespaces">use</link>
246+
<link linkend="language.namespaces.importing">use</link>
247247
</entry>
248248
<entry>
249249
<link linkend="language.oop5.properties">var</link>
@@ -281,30 +281,33 @@
281281
<tbody>
282282
<row>
283283
<entry>
284-
<link linkend="language.constants.predefined">__CLASS__</link>
284+
<link linkend="language.constants.magic">__CLASS__</link>
285285
</entry>
286286
<entry>
287-
<link linkend="language.constants.predefined">__DIR__</link>
287+
<link linkend="language.constants.magic">__DIR__</link>
288288
</entry>
289289
<entry>
290-
<link linkend="language.constants.predefined">__FILE__</link>
290+
<link linkend="language.constants.magic">__FILE__</link>
291291
</entry>
292292
<entry>
293-
<link linkend="language.constants.predefined">__FUNCTION__</link>
293+
<link linkend="language.constants.magic">__FUNCTION__</link>
294294
</entry>
295295
<entry>
296-
<link linkend="language.constants.predefined">__LINE__</link>
297-
</entry>
298-
<entry>
299-
<link linkend="language.constants.predefined">__METHOD__</link>
296+
<link linkend="language.constants.magic">__LINE__</link>
300297
</entry>
301298
</row>
302299
<row>
300+
<entry>
301+
<link linkend="language.constants.magic">__METHOD__</link>
302+
</entry>
303+
<entry>
304+
<link linkend="language.constants.magic">__PROPERTY__</link>
305+
</entry>
303306
<entry>
304307
<link linkend="language.namespaces.nsconstants">__NAMESPACE__</link>
305308
</entry>
306309
<entry>
307-
<link linkend="language.constants.predefined">__TRAIT__</link>
310+
<link linkend="language.constants.magic">__TRAIT__</link>
308311
</entry>
309312
<entry>
310313
</entry>

‎appendices/tokens.xml‎

Lines changed: 9 additions & 8 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:9418ae19ae6ab1d3f1536db986830362b207b1d6 Maintainer: haohappy Status: ready -->
3+
<!-- EN-Revision:a124543dd3f6b1e5567b07420d23899e582514dc Maintainer: haohappy Status: ready -->
44
<!-- CREDITS: class007, mowangjuanzi, Luffy -->
55
<appendix xml:id="tokens" xmlns="http://docbook.org/ns/docbook">
66
<title>解析器记号（token）列表</title>
@@ -30,6 +30,7 @@
3030
<?php
3131
// 在 PHP 7.4.0 之前，未定义 T_FN。
3232
defined('T_FN') || define('T_FN', 10001);
33+
?>
3334
]]>
3435
</programlisting>
3536
</para>
@@ -138,7 +139,7 @@ defined('T_FN') || define('T_FN', 10001);
138139
<entry><constant>T_CLASS_C</constant></entry>
139140
<entry>__CLASS__</entry>
140141
<entry>
141-
<link linkend="language.constants.predefined">魔术常量</link>
142+
<link linkend="language.constants.magic">魔术常量</link>
142143
</entry>
143144
</row>
144145
<row xml:id="constant.t-clone">
@@ -220,7 +221,7 @@ defined('T_FN') || define('T_FN', 10001);
220221
<row xml:id="constant.t-dir">
221222
<entry><constant>T_DIR</constant></entry>
222223
<entry>__DIR__</entry>
223-
<entry><link linkend="language.constants.predefined">逻辑常量</link></entry>
224+
<entry><link linkend="language.constants.magic">逻辑常量</link></entry>
224225
</row>
225226
<row xml:id="constant.t-div-equal">
226227
<entry><constant>T_DIV_EQUAL</constant></entry>
@@ -365,7 +366,7 @@ defined('T_FN') || define('T_FN', 10001);
365366
<row xml:id="constant.t-file">
366367
<entry><constant>T_FILE</constant></entry>
367368
<entry>__FILE__</entry>
368-
<entry><link linkend="language.constants.predefined">魔法常量</link></entry>
369+
<entry><link linkend="language.constants.magic">魔法常量</link></entry>
369370
</row>
370371
<row xml:id="constant.t-final">
371372
<entry><constant>T_FINAL</constant></entry>
@@ -404,7 +405,7 @@ defined('T_FN') || define('T_FN', 10001);
404405
<entry><constant>T_FUNC_C</constant></entry>
405406
<entry>__FUNCTION__</entry>
406407
<entry>
407-
<link linkend="language.constants.predefined">魔法常量</link>
408+
<link linkend="language.constants.magic">魔法常量</link>
408409
</entry>
409410
</row>
410411
<row xml:id="constant.t-global">
@@ -513,7 +514,7 @@ defined('T_FN') || define('T_FN', 10001);
513514
<row xml:id="constant.t-line">
514515
<entry><constant>T_LINE</constant></entry>
515516
<entry>__LINE__</entry>
516-
<entry><link linkend="language.constants.predefined">魔术常量</link></entry>
517+
<entry><link linkend="language.constants.magic">魔术常量</link></entry>
517518
</row>
518519
<row xml:id="constant.t-list">
519520
<entry><constant>T_LIST</constant></entry>
@@ -551,7 +552,7 @@ defined('T_FN') || define('T_FN', 10001);
551552
<entry><constant>T_METHOD_C</constant></entry>
552553
<entry>__METHOD__</entry>
553554
<entry>
554-
<link linkend="language.constants.predefined">魔术常量</link>
555+
<link linkend="language.constants.magic">魔术常量</link>
555556
</entry>
556557
</row>
557558
<row xml:id="constant.t-minus-equal">
@@ -699,7 +700,7 @@ defined('T_FN') || define('T_FN', 10001);
699700
<entry><constant>T_PROPERTY_C</constant></entry>
700701
<entry>__PROPERTY__</entry>
701702
<entry>
702-
<link linkend="language.constants.predefined">魔术常量</link>
703+
<link linkend="language.constants.magic">魔术常量</link>
703704
</entry>
704705
</row>
705706
<row xml:id="constant.t-protected">

‎language/control-structures/include.xml‎

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- $Author$ -->
4-
<!-- Reviewed: no Maintainer: dallas -->
5-
<!-- EN-Revision: ffbe6525350c91d58e1d5b7a52c46c911035c8e0 Maintainer: dallas Status: ready -->
6-
3+
<!-- EN-Revision: a124543dd3f6b1e5567b07420d23899e582514dc Maintainer: dallas Status: ready -->
4+
<!-- CREDITS: Luffy -->
75
<sect1 xml:id="function.include" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
86
<title>include</title>
97
<?phpdoc print-version-for="include"?>
@@ -71,7 +69,7 @@ echo "A $color $fruit"; // A green apple
7169
</para>
7270
<simpara>
7371
如果 include 出现于调用文件中的一个函数里，则被调用的文件中所包含的所有代码将表现得如同它们是在该函数内部定义的一样。所以它将遵循该函数的变量范围。此规则的一个例外是<link
74-
linkend="language.constants.predefined">魔术常量</link>，它们是在发生包含之前就已被解析器处理的。
72+
linkend="language.constants.magic">魔术常量</link>，它们是在发生包含之前就已被解析器处理的。
7573
</simpara>
7674
<para>
7775
<example>

‎language/predefined/variables/server.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: a6d209f4ff71ccba3f1255902827f5df3e092ff9 Maintainer: HonestQiao Status: ready -->
4-
<!-- CREDITS: mowangjuanzi -->
3+
<!-- EN-Revision: a124543dd3f6b1e5567b07420d23899e582514dc Maintainer: HonestQiao Status: ready -->
4+
<!-- CREDITS: mowangjuanzi, Luffy -->
55
<refentry role="variable" xml:id="reserved.variables.server" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false">
66
<refnamediv>
77
<refname>$_SERVER</refname>
@@ -38,7 +38,7 @@
3838
<term>'<varname>PHP_SELF</varname>'</term>
3939
<listitem>
4040
<simpara>
41-
当前执行脚本的文件名，与 document root 有关。例如，在地址为 <filename>http://example.com/foo/bar.php</filename> 的脚本中使用 <varname>$_SERVER['PHP_SELF']</varname> 将得到 <filename>/foo/bar.php</filename>。<link linkend="language.constants.predefined">__FILE__</link> 常量包含当前(例如包含)文件的完整路径和文件名。
41+
当前执行脚本的文件名，与 document root 有关。例如，在地址为 <filename>http://example.com/foo/bar.php</filename> 的脚本中使用 <varname>$_SERVER['PHP_SELF']</varname> 将得到 <filename>/foo/bar.php</filename>。<link linkend="language.constants.magic">__FILE__</link> 常量包含当前(例如包含)文件的完整路径和文件名。
4242
</simpara>
4343
<simpara>
4444
如果 PHP 以命令行模式运行，这个变量将包含脚本名。
@@ -289,7 +289,7 @@
289289
<term>'<varname>SCRIPT_NAME</varname>'</term>
290290
<listitem>
291291
<simpara>
292-
包含当前脚本的路径。这在页面需要指向自己时非常有用。<link linkend="language.constants.predefined">__FILE__</link> 常量包含当前脚本(例如包含文件)的完整路径和文件名。
292+
包含当前脚本的路径。这在页面需要指向自己时非常有用。<link linkend="language.constants.magic">__FILE__</link> 常量包含当前脚本(例如包含文件)的完整路径和文件名。
293293
</simpara>
294294
</listitem>
295295
</varlistentry>

‎reference/errorfunc/functions/debug-backtrace.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-
<!-- EN-Revision: e203b12d7964aa7c729e1f7c26fcbf357fc9fb63 Maintainer: daijie Status: ready -->
4-
<!-- CREDITS: mowangjuanzi -->
3+
<!-- EN-Revision: a124543dd3f6b1e5567b07420d23899e582514dc Maintainer: daijie Status: ready -->
4+
<!-- CREDITS: mowangjuanzi, Luffy -->
55
<refentry xml:id="function.debug-backtrace" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
77
<refname>debug_backtrace</refname>
@@ -133,29 +133,29 @@
133133
<entry>function</entry>
134134
<entry><type>string</type></entry>
135135
<entry>
136-
当前的函数名，参见：<link linkend="language.constants.predefined">__FUNCTION__</link>。
136+
当前的函数名，参见：<link linkend="language.constants.magic">__FUNCTION__</link>。
137137
</entry>
138138
</row>
139139
<row>
140140
<entry>line</entry>
141141
<entry><type>int</type></entry>
142142
<entry>
143-
当前的行号。参见：<link linkend="language.constants.predefined">__LINE__</link>。
143+
当前的行号。参见：<link linkend="language.constants.magic">__LINE__</link>。
144144
</entry>
145145
</row>
146146
<row>
147147
<entry>file</entry>
148148
<entry><type>string</type></entry>
149149
<entry>
150-
当前的文件名。参见：<link linkend="language.constants.predefined">__FILE__</link>。
150+
当前的文件名。参见：<link linkend="language.constants.magic">__FILE__</link>。
151151
</entry>
152152
</row>
153153
<row>
154154
<entry>class</entry>
155155
<entry><type>string</type></entry>
156156
<entry>
157157
当前 <link linkend="language.oop5">class</link>
158-
的名称。参见<link linkend="language.constants.predefined">__CLASS__</link>
158+
的名称。参见<link linkend="language.constants.magic">__CLASS__</link>
159159
</entry>
160160
</row>
161161
<row>

‎reference/misc/functions/define.xml‎

Lines changed: 9 additions & 12 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: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: daijie Status: ready -->
3+
<!-- EN-Revision: a124543dd3f6b1e5567b07420d23899e582514dc Maintainer: daijie Status: ready -->
44
<!-- CREDITS: mowangjuanzi, Luffy -->
55
<refentry xml:id="function.define" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -44,10 +44,7 @@
4444
<term><parameter>value</parameter></term>
4545
<listitem>
4646
<para>
47-
常量的值。在 PHP 5 中，<parameter>value</parameter> 必须是
48-
<type>scalar</type> 值（<type>int</type>、
49-
<type>float</type>、<type>string</type>、<type>boolean</type> 或
50-
&null;）。在 PHP 7 中， <type>array</type> 值也被允许。
47+
常量的值。
5148
</para>
5249
<warning>
5350
<para>
@@ -99,6 +96,12 @@
9996
</row>
10097
</thead>
10198
<tbody>
99+
<row>
100+
<entry>8.1.0</entry>
101+
<entry>
102+
<parameter>value</parameter> 现在可以是一个对象。
103+
</entry>
104+
</row>
102105
<row>
103106
<entry>8.0.0</entry>
104107
<entry>
@@ -112,12 +115,6 @@
112115
废弃了 <parameter>case_insensitive</parameter>，并将在 8.0.0 版中移除。
113116
</entry>
114117
</row>
115-
<row>
116-
<entry>7.0.0</entry>
117-
<entry>
118-
允许 <type>array</type> 的值。
119-
</entry>
120-
</row>
121118
</tbody>
122119
</tgroup>
123120
</informaltable>
@@ -158,7 +155,7 @@ echo ANIMALS[1]; // 输出 "cat"
158155
<title>以保留名称定义常量</title>
159156
<para>
160157
本例子说明了以 <link
161-
linkend="language.constants.predefined">魔术常量</link>相同名称定义常量的<emphasis>能力</emphasis>。由于行为结果过于令人迷惑，所以实践中不推荐。
158+
linkend="language.constants.magic">魔术常量</link>相同名称定义常量的<emphasis>能力</emphasis>。由于行为结果过于令人迷惑，所以实践中不推荐。
162159
</para>
163160
<programlisting role="php">
164161
<![CDATA[

‎reference/misc/functions/pack.xml‎

Lines changed: 4 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: 13732997f37ed612e14f33f7071f7c7ec1858a7c Maintainer: Avenger Status: ready -->
3+
<!-- EN-Revision: c532eceb157530671958a3ef2710bbda3f5ddf68 Maintainer: Avenger Status: ready -->
44
<!-- CREDITS: Luffy, mowangjuanzi -->
55
<refentry xml:id="function.pack" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -251,6 +251,9 @@ $binarydata = pack("nvc*", 0x1234, 0x5678, 65, 66);
251251

252252
<refsect1 role="notes">
253253
&reftitle.notes;
254+
<caution>
255+
<simpara>格式代码 <literal>q</literal>、 <literal>Q</literal>、<literal>J</literal> 和 <literal>P</literal> 在 32 位 PHP 构建中不可用。</simpara>
256+
</caution>
254257
<caution>
255258
<para>
256259
注意，PHP 内部将以有符号的形式存储 <type>int</type> 值，其大小取决于机器。整数文字和运算的结果超出 <type>int</type>

0 commit comments

Comments
 (0)