萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 編寫 C 擴展完整教程:從極簡 Hello World 到帶參數函數

前言

PHP 擴展開發能將核心邏輯下沉到 C 層,獲得極致性能。本文基於 PHP 5.3+ 環境,演示從 ext_skel 生成骨架到編譯安裝、調試驗證的完整流程。

環境準備

  • PHP 源碼包 (如 php-5.3.6.tar.gz)
  • 編譯工具鏈:gcc, make, autoconf, automake, libtool
  • PHP 開發包:php-devel 或 php5-dev (提供 phpize, php-config)

步驟 1:生成擴展骨架

cd php-5.3.6/ext
./ext_skel --extname=hmc
# 生成 hmc/ 目錄,包含 config.m4, hmc.c, php_hmc.h 等

步驟 2:修改 config.m4 啟用擴展

編輯 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])

步驟 3:實現功能代碼

3.1 修改 hmc.c 註冊函數

/* 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");
}

3.2 修改 php_hmc.h 聲明

PHP_FUNCTION(confirm_hmc_compiled);
PHP_FUNCTION(say_hello);  // 新增聲明

步驟 4:編譯安裝

cd hmc
phpize                    # 生成 configure 腳本
./configure --enable-hmc  # 使用啟用選項
make
make install
# 輸出:Installing shared extensions: /usr/lib/php/extensions/no-debug-nts-20100525/hmc.so

步驟 5:配置 php.ini 載入擴展

; php.ini 中 [PHP] 區段添加
extension=hmc.so

# 重啟 Web 服務器或 PHP-FPM
service httpd restart
# 或
systemctl restart php-fpm

步驟 6:驗證安裝

<?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 源碼閱讀。

copyright © 萬盛學電腦網 all rights reserved