- 相關推薦
怎樣編寫一個獨立的PHP擴展
有時候獨立擴展需要是共享的已供其他模塊加載。那么大家知道怎樣編寫一個獨立的PHP擴展嗎?下面一起來看看!
獨立的 PHP 擴展可以獨立于 PHP 源碼之外進行分發。要創建一個這樣的擴展，需要準備好兩樣東西：
配置文件 (config.m4)
你的模塊源碼
接下來我們來描述一下如果創建這些文件并組合起來。
準備好系統工具
想要擴展能夠在系統上編譯并成功運行，需要準備轉以下工具：
GNU autoconf
GNU automake
GNU libtool
GNU m4
以上這些都可以從 ftp://ftp.gnu.org/pub/gnu/ 獲取。
注：以上這些都是類 Unix 環境下才能使用的工具。
改裝一個已經存在的擴展
為了顯示出創建一個獨立的擴展是很容易的事情，我們先將一個已經內嵌到 PHP 的擴展改成獨立擴展。安裝 PHP 并且執行以下命令：
$ mkdir /tmp/newext
$ cd /tmp/newext
現在你已經有了一個空目錄。我們將 mysql 擴展目錄下的文件復制過來：
$ cp -rp php-4.0.X/ext/mysql/* .
# 注：看來這篇 README 真的需要更新一下了
# PHP7 中已經移除了 mysql 擴展部分
到這里擴展就完成了，執行：
$ phpize
現在你可以獨立存放這個目錄下的文件到任何地方，這個擴展可以完全獨立存在了。
用戶在編譯時需要使用以下命令：
$ ./configure
[--with-php-config=/path/to/php-config]
[--with-mysql=MYSQL-DIR]
$ make install
這樣 MySQL 模塊就可以使用內嵌的 MySQL 客戶端庫或者已安裝的位于 MySQL 目錄中的 MySQL。
注：意思是說想要編寫 PHP 擴展，你既需要已經安裝了 PHP，也需要下載一份 PHP 源碼。
定義一個新擴展
我們給示例擴展命名為 “foobar”。
新擴展包含兩個資源文件：foo.c 和 bar.c(還有一些頭文件，但這些不只重要)。
示例擴展不引用任何外部的庫(這點很重要，因為這樣用戶就不需要特別指定一些編譯選項了)。
LTLIBRARY_SOURCES 選項用于指定資源文件的名字，你可以有任意數量的資源文件。
注：上面說的是 Makefile.in 文件中的配置選項，可以參考 xdebug。
修改 m4 后綴的配置文件
m4 配置文件可以指定一些額外的檢查。對于一個獨立擴展來說，你只需要做一些宏調用即可。
PHP_ARG_ENABLE(foobar,whether to enable foobar,
[ --enable-foobar Enable foobar])
if test "$PHP_FOOBAR" != "no"; then
PHP_NEW_EXTENSION(foobar, foo.c bar.c, $ext_shared)
fi
PHP_ARG_ENABLE 會自動設置好正確的變量以保證擴展能夠被 PHP_NEW_EXTENSION 以共享模式啟動。
PHP_NEW_EXTENSION 的第一個參數是擴展的名稱，第二個參數是資源文件。第三個參數$ext_shared 是由 PHP_ARG_ENABLE/WITH 為 PHP_NEW_EXTENSION 設定的。
請始終使用 PHP_ARG_ENABLE 或 PHP_ARG_WITH 進行設置。即使你不打算發布你的 PHP 模塊，這些設置也可以保證讓你的模塊和 PHP 主模塊的接口保持一體。
注：PHP_ARG_ENABLE 和 PHP_ARG_WITH 應該是用于定義模塊是動態擴展還是靜態編譯進 PHP 中，就跟編譯 PHP 時使用的 --enable-xxx 和 --with-xxx 一樣。
創建資源文件
ext_skel 可以為你的 PHP 模塊創建一些通用的代碼，你也可以編寫一些基本函數定義和 C 代碼來處理函數的參數。具體信息可以查看 READNE.EXT_SKEL。
不要擔心沒有范例，PHP 中有很多模塊供你參考，選擇一個簡單的點開始，添加你自己的代碼。
注：ext_skel 可以生成好基本模塊需要的資源文件和配置文件，不需要自己創建。
修改自定義模塊
將 config.m4 文件和資源文件放到同一個目錄中，然后執行 phpize (PHP 4.0 以上的版本編譯 PHP 的時候都安裝了 phpize)。
如果你的 phpize 不在系統環境變量中，你需要指定絕對路徑，例如：
$ /php/bin/phpize
這個命令會自動復制必需的構建文件到當前目錄并根據 config.m4 創建配置文件。
通過以上的步驟，你已經有了一個獨立的擴展了。
安裝擴展
擴展可以通過以下命令編譯安裝：
$ ./configure
[--with-php-config=/path/to/php-config]
$ make install
給模塊添加共享支持
有時候獨立擴展需要是共享的已供其他模塊加載。接下來我會解釋如何給已經創建好的 foo 模塊添加共享支持。
在 config.m4 文件中，使用 PHP_ARG_WITH/PHP_ARG_ENABLE 來設定擴展，這樣就可以自動使用 --with-foo=shared[,..] 或 --enable-foo=shared[,..] 這樣的指令作為編譯參數了。
在 config.m4 文件中，使用 PHP_NEW_EXTENSION(foo,.., $ext_shared) 使擴展可以被構建。
添加以下代碼到你的 C 語言資源文件中：
#ifdef COMPILE_DL_FOO
ZEND_GET_MODULE(foo)
#endif
這一段講的上面都提到過了，這里只是又強調了一下。
【怎樣編寫一個獨立的PHP擴展】相關文章：
php內核分析之擴展10-03
php編寫的一個E-mail驗證類08-26
怎么在yaf框架增加php擴展框架07-24
怎樣學習PHP內容09-17
無需重新編譯php加入ftp擴展的方法09-04
php自定義擴展名獲取函數示例06-10
優秀的PHP程序員是怎樣練成的08-02