本文是以PHP7作為基礎,講解如何從零開始建立一個PHP擴充套件。本文主要講解建立一個擴充套件的基本步驟都有哪些。示例中,我們將實現如下功能:
1 2 3 |
<?php echo say(); ?> |
輸出內容:
1 2 |
$ php ./test.php $ hello word |
在擴充套件中實現一個say方法,呼叫say方法後,輸出 hello word。
第一步:生成程式碼
PHP為我們提供了生成基本程式碼的工具 ext_skel。這個工具在PHP原始碼的./ext目錄下。
1 2 |
$ cd php_src/ext/ $ ./ext_skel --extname=say |
extname引數的值就是副檔名稱。執行ext_skel命令後,這樣在當前目錄下會生成一個與副檔名一樣的目錄。
第二步,修改config.m4配置檔案
config.m4的作用就是配合phpize工具生成configure檔案。configure檔案是用於環境檢測的。檢測擴充套件編譯執行所需的環境是否滿足。現在我們開始修改config.m4檔案。
1 2 |
$ cd ./say $ vim ./config.m4 |
開啟,config.m4檔案後,你會發現這樣一段文字。
1 2 3 4 5 6 7 8 9 10 11 |
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前面的註釋。去掉註釋後的程式碼如下:
1 2 3 4 5 6 7 8 9 10 11 |
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),在其上面增加如下程式碼:
1 2 3 4 5 6 |
PHP_FUNCTION(say) { zend_string *strg; strg = strpprintf(0, "hello word"); RETURN_STR(strg); } |
找到 PHP_FE(confirm_say_compiled, 在上面增加如下程式碼:
1 |
PHP_FE(say, NULL) |
修改後的程式碼如下:
1 2 3 4 5 6 |
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[] */ }; /* }}} */ |
第四步,編譯安裝
編譯擴充套件的步驟如下:
1 2 3 |
$ phpize $ ./configure $ make |
修改php.ini檔案,增加如下程式碼:
1 2 |
[say] extension = say.so |
然後執行,php -m 命令。在輸出的內容中,你會看到say字樣。
第五步,呼叫測試
自己寫一個指令碼,呼叫say方法。看輸出的內容是否符合預期。