從零開始建立一個 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方法。看輸出的內容是否符合預期。

BY KOCOR