869
Php編程
從零開始創建一個 PHP 擴展
從零開始創建一個 PHP 擴展
本文主要講解創建一個擴展的基本步驟都有哪些。示例中，我們將實現如下功能：
echo say();
?>
輸出內容：
$ php ./test.php
$ hello word
在擴展中實現一個say方法，調用say方法後，輸出 hello word。
第一步：生成代碼
PHP為我們提供了生成基本代碼的工具 ext_skel。這個工具在PHP源代碼的./ext目錄下。
$ cd php_src/ext/
$ ./ext_skel --extname=say
extname參數的值就是擴展名稱。執行ext_skel命令後，這樣在當前目錄下會生成一個與擴展名一樣的目錄。
第二步，修改config.m4配置文件
config.m4的作用就是配合phpize工具生成configure文件。configure文件是用於環境檢測的。檢測擴展編譯運行所需的環境是否滿足。現在我們開始修改config.m4文件。
$ cd ./say
$ vim ./config.m4
打開，config.m4文件後，你會發現這樣一段文字。
dnl If your extension references something external, use with:
dnl PHP_ARG_WITH(say, for say support,
dnl Make sure that the comment is aligned:
dnl [ --with-say Include say support])
dnl Otherwise use enable:
dnl PHP_ARG_ENABLE(say, whether to enable say support,
dnl Make sure that the comment is aligned:
dnl [ --enable-say Enable say support])
其中，dnl 是注釋符號。上麵的代碼說，如果你所編寫的擴展如果依賴其它的擴展或者lib庫，需要去掉PHP_ARG_WITH相關代碼的注釋。否則，去掉 PHP_ARG_ENABLE 相關代碼段的注釋。我們編寫的擴展不需要依賴其他的擴展和lib庫。因此，我們去掉PHP_ARG_ENABLE前麵的注釋。去掉注釋後的代碼如下：
dnl If your extension references something external, use with:
dnl PHP_ARG_WITH(say, for say support,
dnl Make sure that the comment is aligned:
dnl [ --with-say Include say support])
dnl Otherwise use enable:
PHP_ARG_ENABLE(say, whether to enable say support,
Make sure that the comment is aligned:
[ --enable-say Enable say support])
第三步，代碼實現
修改say.c文件。實現say方法。
找到PHP_FUNCTION(confirm_say_compiled)，在其上麵增加如下代碼：
PHP_FUNCTION(say)
{
zend_string *strg;
strg = strpprintf(0, "hello word");
RETURN_STR(strg);
}
找到 PHP_FE(confirm_say_compiled, 在上麵增加如下代碼：
PHP_FE(say, NULL)
修改後的代碼如下：
const zend_function_entry say_functions[] = {
PHP_FE(say, NULL) /* For testing, remove later. */
PHP_FE(confirm_say_compiled, NULL) /* For testing, remove later. */
PHP_FE_END /* Must be the last line in say_functions[] */
};
/* }}} */
第四步，編譯安裝
編譯擴展的步驟如下：
$ phpize
$ ./configure
$ make && make install
修改php.ini文件，增加如下代碼：
[say]
extension = say.so
然後執行，php -m 命令。在輸出的內容中，你會看到say字樣。
第五步，調用測試
自己寫一個腳本，調用say方法。看輸出的內容是否符合預期。
最後更新：2017-10-08 18:05:30