PHP 是用 C 語言寫的。對於每個 PHPer 來說，都有著內心的一種希望寫擴展的衝動了吧。然而，缺乏一個很好的切入點。Google 上搜 PHP 擴展開發，大部分都是複製品文章，甚至有些人連操作都沒有操作過就搬運在了自己的博客。不過也有幾篇好教程，但是都是 PHP 5 時代的產物，隱藏著非常多的坑。我會將我自己慢慢踩坑的過程記錄下來，也許這就成了其它人的「教程」了吧。
生成一個擴展想必很多人已經看到很多網上的教程了。大多都是教我們執行這個命令： $./ext_skel--extname=extname。但是，當你 clone 了 PHP 源碼後會發現，master 分支下並沒有 ext/ext_skel 這個文件。所以，我總結了一下：
如果你是直接下載 PHP 的源碼，或者在已經 release 的版本分之下，你可以執行這個命令
$ cd ext
$ ./ext_skel --extname=extname
如果你是直接在 master 分支下，只有 ext_skel.php 文件，這個時候你就直接可以執行這個 PHP 文件
$ cd ext
$ php ext_skel.php --ext extname
由於我是直接在 master 分支下開發的，所以後面的都是默認在 master 分之下的操作。
生成了擴展之後，我們會看到四個文件和一個文件夾。現在這個階段，我們只需要用到兩個文件， .c 文件和 .h 文件。
一個小坑在我們生成好擴展之後，我們可以試著編譯一下
$ phpize
$ ./configure
$ make && make test
我們會驚訝地發現，編譯的時候會有一個 warning。
warning: implicit declaration of function
'ZEND_PARSE_PARAMETERS_NONE' is invalid in C99 [-Wimplicit-function-declaration]
ZEND_PARSE_PARAMETERS_NONE();
^
1 warning generated.
然後你再執行 make test 發現有一個測試沒有通過。沒錯，腳本為我們生成好的文件，居然通不過自己的測試。有沒有覺得很詭異。我們看看 warning 的具體信息。找不到函數 ZEND_PARSE_PARAMETERS_NONE。看了一下文件，發現在第 15 行。看看這個函數名大概也能猜出來是什麼意思了。於是我去 PHP 源碼裡搜了一下。可是我們發現了這樣一個宏定義。
#ifndef zend_parse_parameters_none
#define zend_parse_parameters_none() \
zend_parse_parameters(ZEND_NUM_ARGS(), "")
#endif
替換掉原來的大寫之後，就沒有 warning 了。這也算是官方給我們挖了一個小坑吧。雖然大寫的有宏定義，但是為什麼會報錯，我也不太清楚了。
定義一個函數我想，大多數人寫擴展，肯定至少希望實現一個函數，不會是要幾個全局變量就去寫個擴展的吧（霧
這裡 PHP 給我們提供了一個有用的宏 PHP_FUNCTION。生成好的代碼裡也有定義好的兩個函數，可以參照它的用法。這個宏最終會被翻譯成一個函數。例如 PHP_FUNCTION(name) 最終會被翻譯成 voidzif_name(zend_execute_data*execute_data,zval*return_value)
同時我們看到有定義了這麼一個數組
const zend_function_entry cesium_functions[] = {
PHP_FE(cesium_test1, arginfo_cesium_test1)
PHP_FE(cesium_test2, arginfo_cesium_test2)
PHP_FE_END
};
我們需要將新添加的函數添加到這個數組裡。像這樣
const zend_function_entry cesium_functions[] = {
PHP_FE(cesium_test1, arginfo_cesium_test1)
PHP_FE(cesium_test2, arginfo_cesium_test2)
PHP_FE(name, NULL)
PHP_FE_END
};
記住，結尾不要加分號或者逗號。最後，我們可以個這個函數一個輸出
PHP_FUNCTION(name)
{
php_printf("Hello\n");
}
編譯安裝完了之後我們就可以使用這個函數了
總結本文僅僅是展示了從創建擴展開始到運行的全過程，本著能運行的心態來走完這些流程。
由於作者水平有限，如有錯誤，敬請不吝賜教。
相關講堂推薦