教你如何自學PHP擴展
本文以PHP7作為語言拓展基礎(chǔ),講解教你如何從零開始創(chuàng)建一個PHP擴展。該篇主要講解創(chuàng)建一個擴展的基本步驟。示例中,我們將實現(xiàn)如下功能:
<?php echo sayWord(); ?>
我們讓上面的程序執(zhí)行結(jié)果為:
$ php ./test.php $ hello word
意思為在拓展中實現(xiàn)一個sayWord方法,調(diào)用該sayWord方法后,程序?qū)⑤敵觯篽ello word。下面,我將教大家該方法的實現(xiàn)步奏。
第一步,生成代碼
這里php為我們提供了非常棒的生成基本代碼的工具ext_skel。該工具在php源代碼的./ext目錄里面。
$ cd php_src/ext/ $ ./ext_skel --extname=sayWord
extname參數(shù)的值就是擴展名稱。執(zhí)行ext_skel命令后,這樣在當前目錄下會生成一個與擴展名一樣的目錄。
第二步,修改config.m4配置文件
config.m4的作用就是配合phpize工具生成configure文件。configure文件是用于環(huán)境檢測的。檢測擴展編譯運行所需的環(huán)境是否滿足?,F(xiàn)在我們開始修改config.m4文件。
$ cd ./sayWord $ vim ./config.m4
打開,config.m4文件后,你會發(fā)現(xiàn)這樣一段文字。
dnl If your extension references something external, use with: dnl PHP_ARG_WITH(sayWord, for say support, dnl Make sure that the comment is aligned: dnl [ --with-sayWord Include sayWord support]) dnl Otherwise use enable: dnl PHP_ARG_ENABLE(sayWord, whether to enable say support, dnl Make sure that the comment is aligned: dnl [ --enable-sayWord Enable sayWord support])
其中,dnl 是注釋符號。上面的代碼說,如果你所編寫的擴展如果依賴其它的擴展或者lib庫,需要去掉PHP_ARG_WITH相關(guān)代碼的注釋。否則,去掉 PHP_ARG_ENABLE 相關(guān)代碼段的注釋。我們編寫的擴展不需要依賴其他的擴展和lib庫。因此,我們?nèi)サ鬚HP_ARG_ENABLE前面的注釋。去掉注釋后的代碼如下:
dnl If your extension references something external, use with: dnl PHP_ARG_WITH(sayWord, for sayWord support, dnl Make sure that the comment is aligned: dnl [ --with-sayWord Include sayWord support]) dnl Otherwise use enable: PHP_ARG_ENABLE(sayWord, whether to enable sayWord support, Make sure that the comment is aligned: [ --enable-sayWord Enable sayWord support])
第三步,代碼實現(xiàn)
修改sayWord.c文件。實現(xiàn)sayWord方法。
找到PHP_FUNCTION(confirm_sayWord_compiled),在其上面增加如下代碼:
PHP_FUNCTION(sayWord) { zend_string *strg; strg = strpprintf(0, "hello word"); RETURN_STR(strg); }
找到 PHP_FE(confirm_sayWord_compiled, 在上面增加如下代碼:
PHP_FE(sayWord, NULL)
修改后的代碼如下:
const zend_function_entry say_functions[] = { PHP_FE(sayWord, NULL) /* For testing, remove later. */ PHP_FE(confirm_sayWord_compiled, NULL) /* For testing, remove later. */ PHP_FE_END /* Must be the last line in sayWord_functions[] */ }; /* }}} */
第四步,編譯安裝
編譯擴展的步驟如下:
$ phpize $ ./configure $ make && make install
修改php.ini文件,增加如下代碼:
[sayWord] extension = sayWord.so
然后執(zhí)行,php -m 命令。在輸出的內(nèi)容中,你會看到sayWord字樣。
第五步,調(diào)用測試
自己寫一個php腳本,調(diào)用sayWord方法??摧敵龅膬?nèi)容是否符合預期。
網(wǎng)站建設(shè)首選石家莊尚途網(wǎng)絡(luò)科技有限公司,更多網(wǎng)站優(yōu)化,網(wǎng)站建設(shè)信息請關(guān)注:尚途科技,網(wǎng)址:http://jbbow.cn