### 7.3.4 config.m4
config.m4是擴展的編譯配置文件,它被include到configure.in文件中,最終被autoconf編譯為configure,編寫擴展時我們只需要在config.m4中修改配置即可,一個簡單的擴展配置只需要包含以下內容:
```c
PHP_ARG_WITH(擴展名稱, for mytest support,
Make sure that the comment is aligned:
[ --with-擴展名稱 Include xxx support])
if test "$PHP_擴展名稱" != "no"; then
PHP_NEW_EXTENSION(擴展名稱, 源碼文件列表, $ext_shared,, -DZEND_ENABLE_STATIC_TSRMLS_CACHE=1)
fi
```
PHP在acinclude.m4中基于autoconf/automake的宏封裝了很多可以直接使用的宏,下面介紹幾個比較常用的宏:
__(1)PHP_ARG_WITH(arg_name,check message,help info):__ 定義一個`--with-feature[=arg]`這樣的編譯參數,調用的是autoconf的AC_ARG_WITH,這個宏有5個參數,常用的是前三個,分別表示:參數名、執行./configure是展示信息、執行--help時展示信息,第4個參數為默認值,如果不定義默認為"no",通過這個宏定義的參數可以在config.m4中通過`$PHP_參數名(大寫)`訪問,比如:
```sh
PHP_ARG_WITH(aaa, aaa-configure, help aa)
#后面通過$PHP_AAA就可以讀取到--with-aaa=xxx設置的值了
```
__(2)PHP_ARG_ENABLE(arg_name,check message,help info):__ 定義一個`--enable-feature[=arg]`或`--disable-feature`參數,`--disable-feature`等價于`--enable-feature=no`,這個宏與PHP_ARG_WITH類似,通常情況下如果配置的參數需要額外的arg值會使用PHP_ARG_WITH,而如果不需要arg值,只用于開關配置則會使用PHP_ARG_ENABLE。
__(3)AC_MSG_CHECKING()/AC_MSG_RESULT()/AC_MSG_ERROR():__ ./configure時輸出結果,其中error將會中斷configure執行。
__(4)AC_DEFINE(variable, value, [description]):__ 定義一個宏,比如:`AC_DEFINE(IS_DEBUG, 1, [])`,執行autoheader時將在頭文件中生成:`#define IS_DEBUG 1`。
__(5)PHP_ADD_INCLUDE(path):__ 添加include路徑,即:`gcc -Iinclude_dir`,`#include "file";`將先在通過-I指定的目錄下查找,擴展引用了外部庫或者擴展下分了多個目錄的情況下會用到這個宏。
__(6)PHP_CHECK_LIBRARY(library, function [, action-found [, action-not-found [, extra-libs]]]):__ 檢查依賴的庫中是否存在需要的function,action-found為存在時執行的動作,action-not-found為不存在時執行的動作,比如擴展里使用到線程pthread,檢查pthread_create(),如果沒找到則終止./configure執行:
```sh
PHP_ADD_INCLUDE(pthread, pthread_create, [], [
AC_MSG_ERROR([not find pthread_create() in lib pthread])
])
```
__(7)AC_CHECK_FUNC(function, [action-if-found], [action-if-not-found]):__ 檢查函數是否存在。
__(8)PHP_ADD_LIBRARY_WITH_PATH($LIBNAME, $XXX_DIR/$PHP_LIBDIR, XXX_SHARED_LIBADD):__ 添加鏈接庫。
__(9)PHP_NEW_EXTENSION(extname, sources [, shared [, sapi_class [, extra-cflags [, cxx [, zend_ext]]]]]):__ 注冊一個擴展,添加擴展源文件,確定此擴展是動態庫還是靜態庫,每個擴展的config.m4中都需要通過這個宏完成擴展的編譯配置。
更多autoconf及PHP封裝的宏大家可以在用到的時候再自行檢索,同時ext目錄下有大量的示例可供參考。
- 前言
- 第1章 PHP基本架構
- 1.1 PHP簡介
- 1.2 PHP7的改進
- 1.3 FPM
- 1.3.1 概述
- 1.3.2 基本實現
- 1.3.3 FPM的初始化
- 1.3.4 請求處理
- 1.3.5 進程管理
- 1.4 PHP執行的幾個階段
- 第2章 變量
- 2.1 變量的內部實現
- 2.2 數組
- 2.3 靜態變量
- 2.4 全局變量
- 2.5 常量
- 第3章 Zend虛擬機
- 3.1 PHP代碼的編譯
- 3.1.1 詞法解析、語法解析
- 3.1.2 抽象語法樹編譯流程
- 3.2 函數實現
- 3.2.1 內部函數
- 3.2.2 用戶函數的實現
- 3.3 Zend引擎執行流程
- 3.3.1 基本結構
- 3.3.2 執行流程
- 3.3.3 函數的執行流程
- 3.3.4 全局execute_data和opline
- 3.4 面向對象實現
- 3.4.1 類
- 3.4.2 對象
- 3.4.3 繼承
- 3.4.4 動態屬性
- 3.4.5 魔術方法
- 3.4.6 類的自動加載
- 3.5 運行時緩存
- 3.6 Opcache
- 3.6.1 opcode緩存
- 3.6.2 opcode優化
- 3.6.3 JIT
- 第4章 PHP基礎語法實現
- 4.1 類型轉換
- 4.2 選擇結構
- 4.3 循環結構
- 4.4 中斷及跳轉
- 4.5 include/require
- 4.6 異常處理
- 第5章 內存管理
- 5.1 Zend內存池
- 5.2 垃圾回收
- 第6章 線程安全
- 6.1 什么是線程安全
- 6.2 線程安全資源管理器
- 第7章 擴展開發
- 7.1 概述
- 7.2 擴展的實現原理
- 7.3 擴展的構成及編譯
- 7.3.1 擴展的構成
- 7.3.2 編譯工具
- 7.3.3 編寫擴展的基本步驟
- 7.3.4 config.m4
- 7.4 鉤子函數
- 7.5 運行時配置
- 7.5.1 全局變量
- 7.5.2 ini配置
- 7.6 函數
- 7.6.1 內部函數注冊
- 7.6.2 函數參數解析
- 7.6.3 引用傳參
- 7.6.4 函數返回值
- 7.6.5 函數調用
- 7.7 zval的操作
- 7.7.1 新生成各類型zval
- 7.7.2 獲取zval的值及類型
- 7.7.3 類型轉換
- 7.7.4 引用計數
- 7.7.5 字符串操作
- 7.7.6 數組操作
- 7.8 常量
- 7.9 面向對象
- 7.9.1 內部類注冊
- 7.9.2 定義成員屬性
- 7.9.3 定義成員方法
- 7.9.4 定義常量
- 7.9.5 類的實例化
- 7.10 資源類型
- 7.11 經典擴展解析
- 7.8.1 Yaf
- 7.8.2 Redis
- 第8章 命名空間
- 8.1 概述
- 8.2 命名空間的定義
- 8.2.1 定義語法
- 8.2.2 內部實現
- 8.3 命名空間的使用
- 8.3.1 基本用法
- 8.3.2 use導入
- 8.3.3 動態用法
- 附錄
- break/continue按標簽中斷語法實現
- defer推遲函數調用語法的實現
- 一起線上事故引發的對PHP超時控制的思考