(PHP 4, PHP 5, PHP 7, PHP 8)
declare 結構用來(lái)設定一段代碼的執行指令。declare
的語(yǔ)法和其它流程控制結構相似：
declare (directive)
statement
directive 部分允許設定 declare
代碼段的行為。目前只認識三個(gè)指令：ticks（更多信息見(jiàn)下面
ticks 指令）、
encoding（更多信息見(jiàn)下面 encoding 指令）、
strict_types 指令 (更多信息見(jiàn)類(lèi)型聲明頁(yè)面
嚴格類(lèi)型
章節)。
因為本指令是在文件編譯時(shí)處理的，所以指令只接受字面量的值。 無(wú)法使用變量和常量。下面為你演示：
<?php
// 這樣是有效的：
declare(ticks=1);
// 這樣是無(wú)效的：
const TICK_VALUE = 1;
declare(ticks=TICK_VALUE);
?>
declare 代碼段中的 statement
部分將被執行——怎樣執行以及執行中有什么副作用出現取決于
directive 中設定的指令。
declare 結構也可用于全局范圍，影響到其后的所有代碼（但如果有
declare 結構的文件被其它文件包含，則對包含它的父文件不起作用）。
<?php
// 兩者相等：
// 可以這樣用：
declare(ticks=1) {
// 這里寫(xiě)完整的腳本
}
// 也可以這樣用：
declare(ticks=1);
// 這里寫(xiě)完整的腳本
?>
Tick（時(shí)鐘周期）是一個(gè)在 declare 代碼段中解釋器每執行
N 條可計時(shí)的低級語(yǔ)句就會(huì )發(fā)生的事件。N
的值是在 declare 中的 directive 部分用
ticks=N 來(lái)指定的。
不是所有語(yǔ)句都可計時(shí)。通常條件表達式和參數表達式都不可計時(shí)。
在每個(gè) tick 中出現的事件是由 register_tick_function() 來(lái)指定的。更多細節見(jiàn)下面的例子。注意每個(gè) tick 中可以出現多個(gè)事件。
示例 #1 Tick 的用法示例
<?php
declare(ticks=1);
// 每次 tick 事件都會(huì )調用該函數
function tick_handler()
{
echo "tick_handler() called\n";
}
register_tick_function('tick_handler'); // 引起 tick 事件
$a = 1; // 引起 tick 事件
if ($a > 0) {
$a += 2; // 引起 tick 事件
print($a); // 引起 tick 事件
}
?>
參見(jiàn) register_tick_function() 和 unregister_tick_function()。
可以用 encoding 指令來(lái)對每段腳本指定其編碼方式。
示例 #2 對腳本指定編碼方式
<?php
declare(encoding='ISO-8859-1');
// 在這里寫(xiě)代碼
?>
當和命名空間結合起來(lái)時(shí) declare 的唯一合法語(yǔ)法是
declare(encoding='...');，其中 ...
是編碼的值。而 declare(encoding='...') {}
將在與命名空間結合時(shí)產(chǎn)生解析錯誤。
參見(jiàn) zend.script_encoding。