PHP 擴展開發核心技術總結：線程安全、生命週期與調試實戰

PHP 擴展開發涉及底層內核機制，掌握線程安全、生命週期管理與段錯誤調試是編寫高效穩定擴展的關鍵。本文系統梳理核心知識點，附帶實戰代碼示例。

一、線程安全宏定義（TSRM）

Zend 引擎透過 TSRM（Thread Safe Resource Manager）實現線程隔離。關鍵宏定義解析：

• TSRMLS_D：定義線程上下文指標 void ***tsrm_ls
• TSRMLS_DC：帶逗號的定義形式 , void ***tsrm_ls
• TSRMLS_C / TSRMLS_CC：對應的調用形式

實際應用範例：

// 函數聲明
int php_myext_action(int action_id, char *message TSRMLS_DC);
// 函數調用
php_myext_action(42, "The meaning of life" TSRMLS_CC);

效能提示：TSRMLS_FETCH() 有效能開銷，建議在函數開頭統一聲明，避免重複調用。

二、PHP 生命週期五大階段

無論 CLI 或 Web 模式（SAPI），PHP 執行流程一致：

全域變量管理需配對使用 PHP_GINIT_FUNCTION / PHP_GSHUTDOWN_FUNCTION。

三、段錯誤調試實戰流程

1. 啟用 core dump：ulimit -c unlimited
2. 重現錯誤生成 core 檔案
3. GDB 分析：gdb ./php core.xxxx
4. 使用 bt 查看堆疊追蹤定位問題行

建議在 /etc/bashrc 永久設定 core 大小，並配置 /proc/sys/kernel/core_pattern 自訂檔案命名。

四、核心全域變量宏速查

• EG（Executor Globals）：執行期符號表 EG(active_symbol_table)
• CG（Compiler Globals）：編譯期資訊（函數表、類表）
• PG（PHP Core Globals）：php.ini 設定映射
• SG（SAPI Globals）：Server API 相關資訊

五、zval 類型與值操作宏

類型判斷採用 Z_TYPE_P() 系列，值存取對應宏：

類型轉換函數：convert_to_long()、convert_to_string() 等。

六、常量註冊與 HashTable 遍歷

模組初始化時註冊常量：

REGISTER_LONG_CONSTANT("CONST_NAME", 123, CONST_CS | CONST_PERSISTENT);

HashTable 遍歷標準模式：

HashPosition pos;
for (zend_hash_internal_pointer_reset_ex(ht, &pos);
     zend_hash_get_current_data_ex(ht, (void**)&data, &pos) == SUCCESS;
     zend_hash_move_forward_ex(ht, &pos)) {
    // 處理 data
}

七、第三方庫整合要點

config.m4 關鍵步驟：

1. SEARCH_PATH / SEARCH_FOR 定義搜尋路徑
2. PHP_CHECK_LIBRARY 驗證庫存在性
3. PHP_ADD_INCLUDE / PHP_ADD_LIBRARY_WITH_PATH 設定編譯鏈接參數

掌握以上核心機制，能顯著提升 PHP 擴展開發效率與穩定性。建議結合官方源碼（Zend/zend_API.h、main/php_variables.h 等）深入理解內部實現。