想深入理解 PHP 內核、編寫高效能擴展?本教程帶你從零開始:獲取 PHP 源碼、編譯調試版 PHP、使用 ext_skel 生成骨架、手寫最小擴展、驗證加載,建立「PHP 擴展開發」最小知識閉環。
# 獲取源碼(GitHub 或官網)
git clone https://github.com/php/php-src.git
cd php-src
# 生成 configure
./buildconf --force
# 編譯:禁用所有擴展、開啟 debug、開啟線程安全
./configure --disable-all --enable-debug --enable-maintainer-zts
make -j$(nproc)
# 別名方便調用
alias php-dev=/path/to/php-src/sapi/cli/php
# 驗證
php-dev -v
php-dev -m # 僅顯示 core、date 等內建模塊
cd ext
./ext_skel --extname=myext
# 生成 myext/ 目錄,包含 config.m4、myext.c、php_myext.h 等
# 編輯 config.m4:取消註釋 PHP_ARG_ENABLE 三行
# 返回源碼根目錄重新構建
./buildconf --force
./configure --disable-all --enable-myext --enable-debug --enable-maintainer-zts
make
# 驗證
php-dev -m | grep myext
php-dev -r 'echo confirm_myext_compiled("myext");'
# Congratulations! You have successfully modified ext/myext/config.m4...
在 ext/ 下建立 myext2/,僅需三個核心文件:
PHP_ARG_ENABLE(myext2, whether to enable myext2 support,
[ --enable-myext2 Enable myext2 support])
if test "$PHP_MYEXT2" != "no"; then
PHP_NEW_EXTENSION(myext2, myext2.c, $ext_shared)
fi
#ifndef PHP_MYEXT2_H
#define PHP_MYEXT2_H
extern zend_module_entry myext2_module_entry;
#define phpext_myext2_ptr &myext2_module_entry
#define PHP_MYEXT2_VERSION "0.1.0"
PHP_FUNCTION(hello);
#endif
#include "php.h"
#include "php_myext2.h"
/* 函數表:暴露給 PHP 的函數列表 */
static const zend_function_entry myext2_functions[] = {
PHP_FE(hello, NULL)
PHP_FE_END
};
/* 模塊入口:Zend 引擎識別擴展的核心結構 */
zend_module_entry myext2_module_entry = {
STANDARD_MODULE_HEADER,
"myext2", // 模塊名
myext2_functions, // 函數表
NULL, // MINIT - 模塊啟動
NULL, // MSHUTDOWN - 模塊關閉
NULL, // RINIT - 請求啟動
NULL, // RSHUTDOWN - 請求關閉
NULL, // MINFO - phpinfo 信息
PHP_MYEXT2_VERSION,
STANDARD_MODULE_PROPERTIES
};
#ifdef COMPILE_DL_MYEXT2
ZEND_GET_MODULE(myext2)
#endif
/* 函數實現 */
PHP_FUNCTION(hello) {
php_printf("hello world!\n");
}
cd /path/to/php-src
./buildconf --force
./configure --disable-all --enable-myext2 --enable-debug --enable-maintainer-zts
make
php-dev -m | grep myext2
php-dev -r 'hello();' # 輸出: hello world!
| 結構體/宏 | 作用 | 命名規範 |
|---|---|---|
zend_module_entry | 擴展元數據總入口 | 模塊名_module_entry |
zend_function_entry | 導出函數表 | 模塊名_functions |
PHP_FE(name, arg_info) | 註冊函數條目 | 參數 1 為 PHP 可見函數名 |
PHP_FUNCTION(name) | 展開為 C 函數簽名 | void zim_模塊名_函數名(...) |
php_printf | 向 PHP 輸出流寫入 | 等價於 echo |
zend_module_entry 中 5 個 NULL 位置分別對應:
MINIT:模塊啟動(PHP 啟動時一次),註冊常量、類、資源類型。MSHUTDOWN:模塊關閉(PHP 關閉時一次),釋放全局資源。RINIT:請求啟動(每請求一次),初始化請求級資源。RSHUTDOWN:請求關閉(每請求一次),清理請求級資源。MINFO:phpinfo() 顯示自定義信息。ZEND_PARSE_PARAMETERS_START() 宏解析 zval*。zend_class_entry、PHP_METHOD、zend_declare_property。zend_register_list_destructors_ex 註冊資源析構器。php-src/ext/standard/ 官方擴展源碼。手寫擴展雖枯燥,卻是理解 PHP 內存管理、執行引擎、類系統的最短路徑。建議建立「每月寫一個微擴展」習慣,半年後內核功力將質變。