### 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目錄下有大量的示例可供參考。