PHP 內核探索：CLI SAPI 執行流程與編譯執行機制

CLI SAPI 入口

命令列模式 php -f script.php 觸發流程：

1. 解析參數：php_cli.c 處理 -f、-r、-i 等選項
2. 初始化環境：php_request_startup() 初始化模組、超全域變數
3. 編譯執行：php_execute_script() → zend_execute_scripts()
4. 清理關閉：php_request_shutdown()、模組 RSHUTDOWN

核心：zend_execute_scripts()

ZEND_API void zend_execute_scripts(int type, zval *retval, int file_count, ...) {
    va_list files;
    va_start(files, file_count);
    for (int i = 0; i < file_count; i++) {
        zend_file_handle *fh = va_arg(files, zend_file_handle*);
        // 1. 編譯
        zend_op_array *op_array = zend_compile_file(fh, type);
        // 2. 執行
        if (op_array) {
            zend_execute(op_array, retval);
            destroy_op_array(op_array);
        }
        zend_destroy_file_handle(fh);
    }
    va_end(files);
}

關鍵函數指針：zend_compile_file / zend_execute

• 引擎啟動時賦值預設實現：compile_file = dtrace_compile_file ?: zend_compile
• 為何用函數指針？ 留出擴展鉤子：vld、xdebug、opcache 皆通過替換這兩個指針插桿
• 範例：vld 替換 zend_execute 為 vld_execute，執行前 dump opcode

編譯階段：zend_compile_file()

1. 詞法分析 zend_language_scanner.c → Token 序列
2. 語法分析 zend_language_parser.y (Bison) → AST
3. 生成 zend_op_array：包含 opcode 陣列、常量表、變數名表、類/函數定義

執行階段：zend_execute()

• 基於 zend_vm_execute.h 巨型 switch（或 threaded dispatch）
• 逐條解讀 opcode，操作 zval、棧框、符號表
• 函數調用建立新 zend_execute_data，形成調用棧

Opcode 範例

// 生成 opcode (php -d vld.active=1 -d vld.execute=0 -f test.php)
/*
  0  INIT_FCALL_BY_NAME     'echo'
  1  ADD                    ~0, 1, 2
  2  ASSIGN                 !0, ~0
  3  SEND_VAR               !0
  4  DO_FCALL               1
  5  RETURN                 1
*/

擴展切入點總結

總結

PHP CLI 請求：參數解析 → 啟動 → zend_execute_scripts(compile_file + execute) → 關閉。zend_compile_file 與 zend_execute 兩大函數指針是 Zend 引擎留給擴展的核心擴展點，理解此機制即掌握 Opcode 緩存、除錯器、靜態分析工具的底層原理。