快速開發一個PHP擴展

快速開發一個PHP擴展

做者：heiyeluren
時間：2008-12-5
博客：http://blog.csdn.net/heiyeshuwu

本文經過很是快速的方式講解了如何製做一個PHP 5.2 環境的擴展（PHP Extension），但願可以在圖文的方式下讓想快速學習的朋友瞭解一下製做過程。

需求：好比開發一個叫作 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_test, 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)

擴展製做成功！

 

 

更深刻內容請參考這裏：http://blog.csdn.net/taft/archive/2006/02/10/596291.aspx