declaredeclare

(PHP 4, PHP 5, PHP 7)

declare结构用来设定一段代码的执行指令。declare的语法和其它流程控制结构相似:

declare (directive)
    statement

directive部分允许设定declare代码段的行为。目前只认识两个指令:ticks(更多信息见下面ticks指令)以及encoding(更多信息见下面encoding指令)。

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
?>

Ticks

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();

?>

参见register_tick_function()unregister_tick_function()

淘宝 adsense 商品推荐

谷歌 admob Adsense 代收Pin码 美国 香港 丰富地址代收 商务服务

价格:50元

Encoding

可以用 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

参见zend.script_encoding