PHP 擴展開發能將核心邏輯下沉到 C 層,獲得極致性能。本文基於 PHP 5.3+ 環境,演示從 ext_skel 生成骨架到編譯安裝、調試驗證的完整流程。
php-5.3.6.tar.gz)gcc, make, autoconf, automake, libtoolphp-devel 或 php5-dev (提供 phpize, php-config)cd php-5.3.6/ext
./ext_skel --extname=hmc
# 生成 hmc/ 目錄,包含 config.m4, hmc.c, php_hmc.h 等
編輯 hmc/config.m4,取消註釋以下兩段其一(推薦用 PHP_ARG_ENABLE):
dnl PHP_ARG_ENABLE(hmc, whether to enable hmc support,
dnl Make sure that the comment is aligned:
dnl [ --enable-hmc Enable hmc support])
# 改為(去掉 dnl 並對齊):
PHP_ARG_ENABLE(hmc, whether to enable hmc support,
Make sure that the comment is aligned:
[ --enable-hmc Enable hmc support])
/* hmc_functions[] 註冊導出函數 */
const zend_function_entry hmc_functions[] = {
PHP_FE(say_hello, NULL) // 新增:導出 say_hello
PHP_FE(confirm_hmc_compiled, NULL) // 原有測試函數
{NULL, NULL, NULL}
};
/* 實現 say_hello */
PHP_FUNCTION(say_hello) {
zend_printf("hello world\n");
}
PHP_FUNCTION(confirm_hmc_compiled);
PHP_FUNCTION(say_hello); // 新增聲明
cd hmc
phpize # 生成 configure 腳本
./configure --enable-hmc # 使用啟用選項
make
make install
# 輸出:Installing shared extensions: /usr/lib/php/extensions/no-debug-nts-20100525/hmc.so
; php.ini 中 [PHP] 區段添加
extension=hmc.so
# 重啟 Web 服務器或 PHP-FPM
service httpd restart
# 或
systemctl restart php-fpm
<?php
// c.php
say_hello(); // 輸出: hello world
?>
# 命令行測試
php -q c.php
# 輸出: hello world
# 查看模塊列表
php -m | grep hmc
PHP_FUNCTION(say_hello) {
zval *your_name;
// 參數解析:1 個字符串參數
if (zend_parse_parameters(ZEND_NUM_ARGS(), "z", &your_name) == FAILURE) {
return;
}
convert_to_string(your_name);
zend_printf("hello world, %s\n", Z_STRVAL_P(your_name));
}
// PHP 調用
say_hello("清清月兒"); // 輸出: hello world, 清清月兒
php -m:列出已載入模塊php --ri hmc:顯示擴展信息 (需實現 PHP_MINFO_FUNCTION)gdb php + run c.php:C 級調試valgrind --tool=memcheck php c.php:內存洩漏檢測| 現象 | 原因 | 解決 |
|---|---|---|
phpize 失敗 | 缺少 php-devel/php5-dev | 安裝對應開發包 |
編譯報錯 zend_parse_parameters 未聲明 | 頭文件包含順序/版本不匹配 | 確保 #include "php.h" 在最前 |
運行報 undefined symbol | .so 未正確加載 | 檢查 extension_dir、php.ini、重啟服務 |
PHP 擴展開發流程固定:ext_skel → config.m4 → .c/.h 實現 → phpize → configure → make → install → php.ini。掌握 zend_parse_parameters 參數解析、zval 操作、PHP_FUNCTION 宏展開是核心技能。建議進階學習:PHP Internals Book、ext/standard 源碼閱讀。