怎樣編寫一個獨立的PHP擴展

這期內(nèi)容當中小編將會給大家?guī)碛嘘P(guān)怎樣編寫一個獨立的PHP擴展，文章內(nèi)容豐富且以專業(yè)的角度為大家分析和敘述，閱讀完這篇文章希望大家可以有所收獲。

　　獨立的PHP擴展可以獨立于PHP源碼之外進行分發(fā)。要創(chuàng)建一個這樣的擴展，需要準備好兩樣東西：配置文件(config.m4)你的模塊源碼。接下來億速云小編來講解下怎樣編寫一個獨立的PHP擴展?

　　怎樣編寫一個獨立的PHP擴展

　　準備好系統(tǒng)工具

　　想要擴展能夠在系統(tǒng)上編譯并成功運行，需要準備轉(zhuǎn)以下工具：

　　GNUautoconfGNUautomakeGNUlibtoolGNUm4

　　以上這些都可以從ftp://ftp.gnu.org/pub/gnu/獲取。

　　注：以上這些都是類Unix環(huán)境下才能使用的工具。

　　改裝一個已經(jīng)存在的擴展

　　為了顯示出創(chuàng)建一個獨立的擴展是很容易的事情，我們先將一個已經(jīng)內(nèi)嵌到PHP的擴展改成獨立擴展。安裝PHP并且執(zhí)行以下命令：

　　$mkdir/tmp/newext

　　$cd/tmp/newext

　　現(xiàn)在你已經(jīng)有了一個空目錄。我們將mysql擴展目錄下的文件復制過來：

　　$cp-rpphp-4.0.X/ext/mysql/*.

　　#注：看來這篇README真的需要更新一下了

　　#PHP7中已經(jīng)移除了mysql擴展部分

　　到這里擴展就完成了，執(zhí)行：

　　$phpize

　　現(xiàn)在你可以獨立存放這個目錄下的文件到任何地方，這個擴展可以完全獨立存在了。

　　用戶在編譯時需要使用以下命令：

　　$./configure

　　[--with-php-config=/path/to/php-config]

　　[--with-mysql=MYSQL-DIR]

　　$makeinstall

　　這樣MySQL模塊就可以使用內(nèi)嵌的MySQL客戶端庫或者已安裝的位于MySQL目錄中的MySQL。

　　注：意思是說想要編寫PHP擴展，你既需要已經(jīng)安裝了PHP，也需要下載一份PHP源碼。

　　怎樣編寫一個獨立的PHP擴展

　　定義一個新擴展

　　我們給示例擴展命名為“foobar”。

　　新擴展包含兩個資源文件：foo.c和bar.c(還有一些頭文件，但這些不只重要)。

　　示例擴展不引用任何外部的庫(這點很重要，因為這樣用戶就不需要特別指定一些編譯選項了)。

　　LTLIBRARY_SOURCES選項用于指定資源文件的名字，你可以有任意數(shù)量的資源文件。

　　注：上面說的是Makefile.in文件中的配置選項，可以參考xdebug。

　　修改m4后綴的配置文件

　　m4配置文件可以指定一些額外的檢查。對于一個獨立擴展來說，你只需要做一些宏調(diào)用即可。

　　PHP_ARG_ENABLE(foobar,whethertoenablefoobar,

　　[--enable-foobarEnablefoobar])

　　iftest"$PHP_FOOBAR"!="no";then

　　PHP_NEW_EXTENSION(foobar,foo.cbar.c,$ext_shared)

　　fi

　　PHP_ARG_ENABLE會自動設置好正確的變量以保證擴展能夠被PHP_NEW_EXTENSION以共享模式啟動。

　　PHP_NEW_EXTENSION的第一個參數(shù)是擴展的名稱，第二個參數(shù)是資源文件。第三個參數(shù)$ext_shared是由PHP_ARG_ENABLE/WITH為PHP_NEW_EXTENSION設定的。

　　請始終使用PHP_ARG_ENABLE或PHP_ARG_WITH進行設置。即使你不打算發(fā)布你的PHP模塊，這些設置也可以保證讓你的模塊和PHP主模塊的接口保持一體。

　　注：PHP_ARG_ENABLE和PHP_ARG_WITH應該是用于定義模塊是動態(tài)擴展還是靜態(tài)編譯進PHP中，就跟編譯PHP時使用的--enable-xxx和--with-xxx一樣。

　　創(chuàng)建資源文件

　　ext_skel可以為你的PHP模塊創(chuàng)建一些通用的代碼，你也可以編寫一些基本函數(shù)定義和C代碼來處理函數(shù)的參數(shù)。具體信息可以查看READNE.EXT_SKEL。

　　不要擔心沒有范例，PHP中有很多模塊供你參考，選擇一個簡單的點開始，添加你自己的代碼。

　　注：ext_skel可以生成好基本模塊需要的資源文件和配置文件，不需要自己創(chuàng)建。

　　修改自定義模塊

　　將config.m4文件和資源文件放到同一個目錄中，然后執(zhí)行phpize(PHP4.0以上的版本編譯PHP的時候都安裝了phpize)。

　　假如你的phpize不在系統(tǒng)環(huán)境變量中，你需要指定絕對路徑，例如：

　　$/php/bin/phpize

　　這個命令會自動復制必需的構(gòu)建文件到當前目錄并根據(jù)config.m4創(chuàng)建配置文件。

　　通過以上的步驟，你已經(jīng)有了一個獨立的擴展了。

　　安裝擴展

　　擴展可以通過以下命令編譯安裝：

　　$./configure

　　[--with-php-config=/path/to/php-config]

　　$makeinstall

　　給模塊添加共享支持

　　有時候獨立擴展需要是共享的已供其他模塊加載。接下來我會解釋如何給已經(jīng)創(chuàng)建好的foo模塊添加共享支持。

　　在config.m4文件中，使用PHP_ARG_WITH/PHP_ARG_ENABLE來設定擴展，這樣就可以自動使用--with-foo=shared[,..]或--enable-foo=shared[,..]這樣的指令作為編譯參數(shù)了。在config.m4文件中，使用PHP_NEW_EXTENSION(foo,..,$ext_shared)使擴展可以被構(gòu)建。添加以下代碼到你的C語言資源文件中：

　　#ifdefCOMPILE_DL_FOO

　　ZEND_GET_MODULE(foo)

　　#endif

　　這一段講的上面都提到過了，這里只是又強調(diào)了一下。

　　PECL網(wǎng)站約定

　　假如你打算發(fā)布你的擴展到PECL的網(wǎng)站，需要考慮以下幾點：

　　添加LICENSE或COPYING到package.xml需要在擴展頭文件中定義好版本信息，這個宏會被foo_module_entry調(diào)用來聲明擴展版本：

　　#definePHP_FOO_VERSION"1.2.3"

上述就是小編為大家分享的怎樣編寫一個獨立的PHP擴展了，如果剛好有類似的疑惑，不妨參照上述分析進行理解。如果想知道更多相關(guān)知識，歡迎關(guān)注億速云行業(yè)資訊頻道。