[TOC] (PHP 4, PHP 5, PHP 7) 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 ?> ~~~ ### Ticks Tick（時鐘周期）是一個在 declare 代碼段中解釋器每執行 N 條可計時的低級語句就會發生的事件。N 的值是在 declare 中的 directive 部分用 ticks=N 來指定的。 不是所有語句都可計時。通常條件表達式和參數表達式都不可計時。 在每個 tick 中出現的事件是由 register_tick_function() 來指定的。更多細節見下面的例子。注意每個 tick 中可以出現多個事件。 ## 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); } ?> ~~~ ## 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()。 Encoding 可以用 encoding 指令來對每段腳本指定其編碼方式。 ## 對腳本指定編碼方式 ~~~ <?php declare(encoding='ISO-8859-1'); // code here ?> ~~~ ### Caution 當和命名空間結合起來時 declare 的唯一合法語法是 declare(encoding='...');，其中 ... 是編碼的值。而 declare(encoding='...') {} 將在與命名空間結合時產生解析錯誤。 在 PHP 5.3 中除非在編譯時指定了 --enable-zend-multibyte，否則 declare 中的 encoding 值會被忽略。 注意除非用 phpinfo()，否則 PHP 不會顯示出是否在編譯時指定了 --enable-zend-multibyte。 參見 zend.script_encoding。