萬盛學電腦網

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

PHP 擴展開發入門教程:從源碼編譯到手寫 Hello World 擴展的完整實戰

想深入理解 PHP 內核、編寫高效能擴展?本教程帶你從零開始:獲取 PHP 源碼、編譯調試版 PHP、使用 ext_skel 生成骨架、手寫最小擴展、驗證加載,建立「PHP 擴展開發」最小知識閉環。

環境準備:編譯調試版 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 等內建模塊

方法一:ext_skel 快速生成骨架

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/,僅需三個核心文件:

1. config.m4 — 構建配置

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

2. php_myext2.h — 導出符號與版本

#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

3. myext2.c — 核心實現

#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() 顯示自定義信息。

下一步學習路線

  1. 實現帶參數函數:ZEND_PARSE_PARAMETERS_START() 宏解析 zval*。
  2. 定義類與方法:zend_class_entry、PHP_METHOD、zend_declare_property。
  3. 資源管理:zend_register_list_destructors_ex 註冊資源析構器。
  4. 閱讀《PHP Internals Book》、php-src/ext/standard/ 官方擴展源碼。

手寫擴展雖枯燥,卻是理解 PHP 內存管理、執行引擎、類系統的最短路徑。建議建立「每月寫一個微擴展」習慣,半年後內核功力將質變。

copyright © 萬盛學電腦網 all rights reserved