declare 结构用来设定一段代码的执行指令。declare的语法和其它流程控制结构相似:
declare (directive) statement
directive 部分允许设定 declare代码段的行为。目前只认识两个指令:ticks(更多信息见下面 ticks 指令)以及 encoding(更多信息见下面 encoding 指令)。
Note: encoding 是 PHP 5.3.0 新增指令。
declare 代码段中的 statement部分将被执行——怎样执行以及执行中有什么副作用出现取决于 directive 中设定的指令。
declare 结构也可用于全局范围,影响到其后的所有代码(但如果有 declare 结构的文件被其它文件包含,则对包含它的父文件不起作用)。
- <?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
- ?>
Tick(时钟周期)是一个在 declare 代码段中解释器每执行 N 条可计时的低级语句就会发生的事件。 N 的值是在 declare 中的 directive 部分用 ticks= N
来指定的。
不是所有语句都可计时。通常条件表达式和参数表达式都不可计时。
在每个 tick 中出现的事件是由 register_tick_function() 来指定的。更多细节见下面的例子。注意每个 tick 中可以出现多个事件。
Example #1 Tick 的用法示例
- <?php
- declare( ticks = 1 );
- // A function called on each tick event
- function tick_handler ()
- {
- echo "tick_handler() called/n" ;
- }
- register_tick_function ( 'tick_handler' );
- $a = 1 ;
- if ( $a > 0 ) {
- $a += 2 ;
- print( $a );
- }
- ?>
Example #2 Ticks 的用法示例
- <?php
- function tick_handler ()
- {
- echo "tick_handler() called/n" ;
- }
- $a = 1 ;
- tick_handler ();
- if ( $a > 0 ) {
- $a += 2 ;
- tick_handler ();
- print( $a );
- tick_handler ();
- }
- tick_handler ();
- ?>
可以用 encoding 指令来对每段脚本指定其编码方式。
Example #3 对脚本指定编码方式
- <?php
- declare( encoding = 'ISO-8859-1' );
- // code here
- ?>
当和命名空间结合起来时 declare 的唯一合法语法是 declare(encoding='...');,其中 ...是编码的值。而 declare(encoding='...') {}将在与命名空间结合时产生解析错误。
在 PHP 5.3 中除非在编译时指定了 --enable-zend-multibyte,否则 declare 中的 encoding 值会被忽略。
注意除非用 phpinfo() ,否则 PHP 不会显示出是否在编译时指定了 --enable-zend-multibyte。