com doc/zh: Sync with EN: language/control-structures/declare.xml
| From: | Dai Jie | Date: | Sun, 17 Jan 2021 17:11:32 +0000 |
| Subject: | com doc/zh: Sync with EN: language/control-structures/declare.xml | ||
| Groups: | php.doc.zh | ||
| Request: | Send a blank email to doc-zh+get-5926@lists.php.net to get a copy of this message | ||
Commit: af4086ae5276d500045c4e6c6a579eb0358aed46
Author: 戴劼 <daijie@php.net> Mon, 18 Jan 2021 01:11:32 +0800
Parents: fe7e4ac02d231f546fba7ad32fbc2b0ddf9f05c8
Branches: master
Link: http://git.php.net/?p=doc/zh.git;a=commitdiff;h=af4086ae5276d500045c4e6c6a579eb0358aed46
Log:
Sync with EN
Changed paths:
M language/control-structures/declare.xml
Diff:
diff --git a/language/control-structures/declare.xml b/language/control-structures/declare.xml
index 8d1a8fb4..d1f6e0dd 100644
--- a/language/control-structures/declare.xml
+++ b/language/control-structures/declare.xml
@@ -2,10 +2,10 @@
<!-- $Revision$ -->
<!-- $Author$ -->
<!-- Reviewed: yes Maintainer: dallas -->
-<!-- EN-Revision: 3ac3e340846ebed0f806322504139b0116b96714 Maintainer: dallas Status: ready
-->
+<!-- EN-Revision: 7104ee97ced1768a3231588dfc0bc0d7eb1117ad Maintainer: dallas Status: ready
-->
<sect1 xml:id="control-structures.declare" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
- <title><literal>declare</literal></title>
+ <title>declare</title>
<?phpdoc print-version-for="declare"?>
<para>
<literal>declare</literal>
结构用来设定一段代码的执行指令。<literal>declare</literal>
@@ -21,16 +21,32 @@ declare (directive)
</para>
<para>
<literal>directive</literal> 部分允许设定
<literal>declare</literal>
-
代码段的行为。目前只认识两个指令:<literal>ticks</literal>(更多信息见下面
- <link linkend="control-structures.declare.ticks">ticks</link>
指令)以及
+
代码段的行为。目前只认识三个指令:<literal>ticks</literal>(更多信息见下面
+ <link linkend="control-structures.declare.ticks">ticks</link> 指令)、
<literal>encoding</literal>(更多信息见下面 <link
- linkend="control-structures.declare.encoding">encoding</link> 指令)。
+ linkend="control-structures.declare.encoding">encoding</link> 指令)、
+ <literal>strict_types</literal> 指令 (更多信息见函数参数页面
+ <link linkend="language.types.declarations.strict">严格类型</link>
+ 章节)。
+ </para>
+ <para>
+ 因为本指令是在文件编译时处理的,所以指令只接受字面量的值。
+ 无法使用变量和常量。下面为你演示:
+ <informalexample>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+// 这样是有效的:
+declare(ticks=1);
+
+// 这样是无效的:
+const TICK_VALUE = 1;
+declare(ticks=TICK_VALUE);
+?>
+]]>
+ </programlisting>
+ </informalexample>
</para>
- <note>
- <simpara>
- encoding 是 PHP 5.3.0 新增指令。
- </simpara>
- </note>
<para>
<literal>declare</literal> 代码段中的 <literal>statement</literal>
部分将被执行——怎样执行以及执行中有什么副作用出现取决于
@@ -43,16 +59,16 @@ declare (directive)
<programlisting role="php">
<![CDATA[
<?php
-// these are the same:
+// 两者相等:
-// you can use this:
+// 可以这样用:
declare(ticks=1) {
- // entire script here
+ // 这里写完整的脚本
}
-// or you can use this:
+// 也可以这样用:
declare(ticks=1);
-// entire script here
+// 这里写完整的脚本
?>
]]>
</programlisting>
@@ -83,7 +99,7 @@ declare(ticks=1);
declare(ticks=1);
-// A function called on each tick event
+// 每次 tick 事件都会调用该函数
function tick_handler()
{
echo "tick_handler() called\n";
@@ -140,14 +156,14 @@ tick_handler();
<sect2 xml:id="control-structures.declare.encoding">
<title>Encoding</title>
<para>
- 可以用 encoding 指令来对每段脚本指定其编码方式。
+ 可以用 <literal>encoding</literal>
指令来对每段脚本指定其编码方式。
<example>
<title>对脚本指定编码方式</title>
<programlisting role="php">
<![CDATA[
<?php
declare(encoding='ISO-8859-1');
-// code here
+// 在这里写代码
?>
]]>
</programlisting>
@@ -163,21 +179,8 @@ declare(encoding='ISO-8859-1');
</simpara>
</caution>
<para>
- 在 PHP 5.3 中除非在编译时指定了
- <literal>--enable-zend-multibyte</literal>,否则 declare 中的 encoding
值会被忽略。
- </para>
- <para>
- 注意除非用 <function>phpinfo</function>,否则 PHP
- 不会显示出是否在编译时指定了
<literal>--enable-zend-multibyte</literal>。
- </para>
- <para>
参见 <link
linkend="ini.zend.script-encoding">zend.script_encoding</link>。
</para>
- <!-- FIXME PHP_6
- In PHP 6.0, the <literal>encoding</literal>
- directive will be used to inform the scanner what encoding the file is created in. Legal
- values are encoding names such as <literal>UTF-8</literal>.
- -->
</sect2>
</sect1>