PHP declare 與 ticks 指令：低層語句級回調機制詳解

declare 是 PHP 的流程控制結構，目前支援 ticks 與 encoding 兩個指令。其中 ticks 配合 register_tick_function() 可在「每 N 條低層語句」執行一次回調，適用於效能分析、記憶體監控、死循環保護等場景。

語法結構

<?php
declare (directive) statement
// 或
declare (directive) {
    // 程式碼區塊
}

什麼是「低層語句」？

PHP 內核將執行單位劃分為三類，每類計為 1 條語句：

• 簡單語句：; (空語句)、return、break、continue、throw、goto、global、static、unset、echo、HTML 文本、以分號結尾的表達式
• 複合語句：完整的 if/elseif、while、do...while、for、foreach、switch、try...catch
• 語句塊：{ ... } 括起的區塊
• 特殊：declare 區塊本身也計 1 句

實戰範例：每條語句輸出一次除錯資訊

<?php
function do_tick() {
    echo "<font color=red>do_tick</font>";
}
register_tick_function('do_tick');

declare(ticks = 1) {
    for ($i = 1; $i < 5; $i++) {
        echo "<font color=blue>{$i}</font><br>";
    }
}
// 輸出會在每條低層語句間穿插 "do_tick"

進階用法：動態註冊/解除回調

<?php
function profile_memory() {
    static $peak = 0;
    $current = memory_get_usage(true);
    if ($current > $peak) $peak = $current;
    echo "Mem: " . ($current/1024/1024) . " MB (Peak: " . ($peak/1024/1024) . " MB)<br>";
}

register_tick_function('profile_memory');
declare(ticks = 100) { // 每 100 條語句採樣一次
    // 大量資料處理邏輯...
    $data = range(1, 100000);
    $result = array_map(function($x) { return $x * 2; }, $data);
}
unregister_tick_function('profile_memory'); // 結束後解除

適用場景與限制

• 限制：declare(ticks) 僅影響當前檔案/作用域內的程式碼，不會 跳入 `include`/`require` 的外部檔案，也不會影響內建函數（C 層）的執行。
• 版本：PHP 5.3+ 完整支援；PHP 7+ 效能大幅提升。

雖然 ticks 機制在現代 PHP 開發中較少直接使用（多由 Xdebug、Blackfire 等工具底層利用），但理解其原理有助於深入掌握 PHP 內核執行模型，並在極端場景下實現輕量級的運行時監控。