編寫第一個 PHP 擴展：從骨架到編譯載入完整流程

PHP 擴展開發入門實戰：建立最小骨架（config.m4、php_sample.h、sample.c），理解 zend_module_entry 結構，編譯安裝並驗證載入。

一、目錄結構與檔案

php-src/ext/sample/
├── config.m4          # 建構配置
├── php_sample.h       # 頭文件：常數、入口宣告
└── sample.c           # 核心實作

二、config.m4 —— 建構系統整合

PHP_ARG_ENABLE(sample, [Whether to enable the "sample" extension],
    [  --enable-sample    Enable "sample" extension support])

if test "$PHP_SAMPLE" != "no"; then
    PHP_SUBST(SAMPLE_SHARED_LIBADD)
    PHP_NEW_EXTENSION(sample, sample.c, $ext_shared)
fi

• PHP_ARG_ENABLE：產生 --enable-sample 選項，無外部依賴用 enable；有依賴用 PHP_ARG_WITH (產生 --with-sample)。
• PHP_NEW_EXTENSION：宣告擴展名稱、源檔列表、共享模組標記。

三、php_sample.h —— 介面定義

#ifndef PHP_SAMPLE_H
#define PHP_SAMPLE_H

#define PHP_SAMPLE_EXTNAME "sample"
#define PHP_SAMPLE_EXTVER  "1.0"

#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include "php.h"  // 核心 API 總入口

extern zend_module_entry sample_module_entry;
#define phpext_sample_ptr &sample_module_entry

#endif

• 防重複包含守衛。
• HAVE_CONFIG_H：phpize 建構時由 config.h 定義。
• php.h 包含核心所有公共 API 頭文件。
• zend_module_entry 宣告為 extern，供 dlopen()/dlsym() 尋找入口。

四、sample.c —— 最小實作

#include "php_sample.h"

zend_module_entry sample_module_entry = {
#if ZEND_MODULE_API_NO >= 20010901
    STANDARD_MODULE_HEADER,
#endif
    PHP_SAMPLE_EXTNAME,
    NULL,                    // Functions (function_entry 陣列)
    NULL,                    // MINIT
    NULL,                    // MSHUTDOWN
    NULL,                    // RINIT
    NULL,                    // RSHUTDOWN
    NULL,                    // MINFO
#if ZEND_MODULE_API_NO >= 20010901
    PHP_SAMPLE_EXTVER,
#endif
    STANDARD_MODULE_PROPERTIES
};

#ifdef COMPILE_DL_SAMPLE
ZEND_GET_MODULE(sample)  // 共享模組導出符號
#endif

五、編譯安裝驗證流程

1. cd php-src/ext/sample
2. phpize（生成 configure、Makefile 等建構檔）。
3. ./configure --enable-sample --enable-debug --enable-maintainer-zts
4. make
5. make install（輸出 .so 至擴展目錄）。
6. 編輯 php.ini 加入 extension=sample.so。
7. php -m | grep sample 驗證。

六、關鍵宏說明

七、下一步

在 function_entry 陣列加入自訂函式，實作 PHP_FUNCTION()，即可開始真正的擴展功能開發。

1. 上一篇文章： C# TreeView 聯動選中：父節點選中自動勾選所有子節點完整實現
2. 下一篇文章： PHP 擴展開發：函式回傳值機制與 RETURN_VALUE 宏詳解

PHP 綜合知識

ThinkPHP 框架架構設計與擴展機制深度解析

ThinkPHP 作為國內知名 PHP 框架，其分層架構、U

PHP 中 Unicode 與 UTF-8 編碼深度解析：轉換原理與實戰代碼

Unicode 與 UTF-8 的核心差異 Unicode

PHP 微信公眾平台接口配置與 Access Token 獲取完整教程

開發前準備 註冊微信訂閱號：微信公眾平台 註冊新浪雲 SA

Laravel env() 函數讀取環境變量為 null 根因分析與解決方案

問題現象 在 Laravel 專案中，執行 php arti