快速開發一個PHP擴展圖文教程

需求：比如開發一個叫做 heiyeluren 的擴展，擴展裡就一個函數 heiyeluren_test()，輸入一個字符串，函數返回：Your input string: xxxxx。
要求：了解C/C++編程，熟悉PHP編程
環境：下載一份php對應版本的源碼，我這裡是 php-5.2.6，先正常安裝php，假設我們的php安裝在 /usr/local/php 目錄，源碼在 /root/soft/php/php-5.2.6/，現在開始！
步驟一：生成擴展框架

cd /root/soft/php/php-5.2.6/ext
./ext_skel --extname=heiyeluren
cd /root/soft/php/php-5.2.6/ext/heiyeluren
vi config.m4
打開文件後去掉 dnl ，獲得下面的信息：
PHP_ARG_ENABLE(heiyeluren, whether to enable heiyeluren support,
[  --enable-heiyeluren           Enable heiyeluren support])
保存退出.
(圖01)

 

 

第二步：編寫代碼

vi php_heiyeluren.h
找到：PHP_FUNCTION(confirm_heiyeluren_compiled); ，新增一行：
PHP_FUNCTION(heiyeluren_test);
保存退出。
(圖02)

vi heiyeluren.c
數組裡增加我們的函數，找到 zend_function_entry heiyeluren_functions[]，增加：
PHP_FE(heiyeluren, NULL)
(圖03)

 

再到 heiyeluren.c 文件最後面增加如下代碼：
PHP_FUNCTION(heiyeluren_test)
{
    char *arg = NULL;
    int arg_len, len;
    char *strg;

    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &arg, &arg_len) == FAILURE) {
        return;
    }

    len = spprintf(&strg, 0, "Your input string: %s\n", arg);
    RETURN_STRINGL(strg, len, 0);
}
保存退出。
(圖04)

 

 

 

第三步：編譯安裝

cd /root/soft/php/php-5.2.6/ext/heiyeluren
/usr/local/php/bin/phpize
./configure --with-php-config=/usr/local/php/bin/php-config
make
make test
make install

現在看看是不是有個 /usr/local/php/lib/php/extensions/no-debug-non-zts-20060613/heiyeluren.so
編輯php.ini，把擴展加入進去：
vi /usr/local/php/lib/php.ini
在[PHP]模塊下增加：
extension = heiyeluren.so
保存退出。
(圖05)

 

注意：如果你不存在擴展文件目錄，或者安裝報錯，那麼可以自行建立這個目錄，然後把擴展拷貝到目錄下，然後記得把 php.ini 文件中的 extension_dir 修改為該目錄：
extension_dir = "/usr/local/php/lib/php/extensions/no-debug-non-zts-20060613/"
(圖06)

 

 

第四步：檢查安裝結果
現在看看模塊加載了沒有：
/usr/local/php/bin/php -m，應該會打印出：
[PHP Modules]
...
heiyeluren
...
[Zend Modules]

然後重啟apache，輸出 phpinfo() ，應該能夠看到：
heiyeluren
heiyeluren support enabled
(圖07)

 

看看函數是否存在並且調用，在web目錄下建立：heiyeluren.php
<?php
echo "<pre>";
print_r(get_loaded_extensions());
print_r(get_extension_funcs('heiyeluren'));
echo heiyeluren_test('My first php extension');
echo "</pre>";
?>
訪問apache，應該能夠看到：
Array
(
    ...
    [33] => heiyeluren
)
Array
(
    [0] => confirm_heiyeluren_compiled
    [1] => heiyeluren_test
)
Your input string: heiyeluren
(圖08)

擴展制作成功！