自己動手用C擴展PHP(一)


首先,我們應該選擇如何去構建我們的擴展模塊,有三種方式:

 

1、External Modules:外部模塊,也就是編譯成共享庫,用dl()函數動態加載。

 

好處:

(1)不需要重新編譯PHP
(2)PHP體積小,因為不需要編譯進PHP

 

缺點:

(1)每次*.php腳本執行都需要用dl()去加載,效率較低
(2)每次都要調用dl()

 

2、Built-in Modules:編譯進PHP

 

好處:

(1)不需要動態加載,模塊在php腳本里面可以直接使用。
(2)不需要將模塊編譯成.so共享庫,因為直接編譯進PHP。

 

缺點:

(1)對模塊的改變都需要重新編譯PHP
(2)因為編譯進PHP,所以PHP二進制文件較大,而且多占點內存

 

3、The Zend Engine:Zend核心里實現(略……有興趣的話可以看Zend API)

 

Note:本人推薦用第2種方式,直接編譯進PHP,但是在下面示例里,我們編譯成外部模塊,因為,外部模塊不需要重新編譯PHP,所以在測試階段先編譯成共享庫,然后用dl()加載(不過記得在php.ini里將安全模式設為Off),測試完后再用第2種方式重新編譯進PHP。

 

一、首先下載PHP源代碼,解壓。然后我們開始構建代碼結構,可以利用PHP源代碼包ext目錄里提供的ext_skel程序去生成我們需要的結構。

 

[ext]#./ext_skel --extname=haosoft_php_module

 

這樣會在ext下生成一個haosoft_php_module目錄。目錄里有config.m4、haosoft_php_module.h和haosoft_php_module.c等幾個文件。

 

二、haosoft_php_module.h為模塊的頭文件(熟悉C語言的應該了解),用VI打開,刪除其中的一行:

 

PHP_FUNCTION(confirm_MyExt_compiled);

 

改為:

 

PHP_FUNCTION(haosoft_test);

 

說明:PHP_FUNCTION()是一個Zend Macro,作用是聲名一個C函數,使他在PHP腳本里可用。參數是函數的名字,我們這里的示例函數為haosoft_test。

 

三、haosoft_php_module.c為主文件,里面包含了實現,VI打開,我們刪除掉

 

PHP_FUNCTION(confirm_MyExt_compiled)
{
    char *arg = NULL;
    int arg_len, len;
    char string[256];

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

    len = sprintf(string, "Congratulations! You have successfully modified ext/%.78s/config.m4. Module %.78s is now compiled into PHP.", "haosoft_php_module", arg);

 

    RETURN_STRINGL(string, len, 1);
}

 

增加:

 

PHP_FUNCTION(haosoft_test)
{
    zend_printf("This is my php module !");
}

 

四、現在,我們開始編譯我們的模塊,因為要編譯成so,我們選擇手工編譯。

 

進入ext目錄:

 

開始編譯,編譯成*.o對象文件,注意這個"-DCOMPILE_DL_HAOSOFT_PHP_MODULE",在haosoft_php_module.c里你可以找到下面的語句:

 

#ifdef COMPILE_DL_HAOSOFT_PHP_MODULE
ZEND_GET_MODULE(haosoft_php_module)
#endif

 

HAOSOFT_PHP_MODULE是大寫模塊名,你可以換成其他名,但是必須保證這個預處理常量與上面的語句里一致,至於上面語句的ZEND_GET_MODULE(haosoft_php_module)我們將在下一篇文章講解它的意思。

 

[ext]# cc -fpic -DCOMPILE_DL_HAOSOFT_PHP_MODULE=1 -I/usr/local/include -I. -I../main -I.. -I../TSRM -I../Zend -c -o haosoft_php_module/haosoft_php_module.o haosoft_php_module/haosoft_php_module.c

 

執行完之后會在目錄下生成一個haosoft_php_module.o文件,接下來,連接:

 

[ext]# cc -shared -L/usr/local/lib -rdynamic -o haosoft_php_module/haosoft_php_module.so haosoft_php_module/haosoft_php_module.o

 

這樣會在目錄下生成了我們需要的haosoft_php_module.so文件。然后我們要建立一個目錄:

 

[ext]# mkdir -p /usr/local/php/lib/php/extensions/no-debug-non-zts-20041030

 

上面的20041030的號碼是Zend內部模塊API號碼,如果你不知道的話,你先建立一個php文件test.php:

 

<?php
dl("abc.so");
?>

 

在瀏覽器里運行該文件會出現錯誤信息,可以在錯誤信息里得到這個號碼,請根據自己情況根據這個號碼與你的PHP安裝目錄更改路徑。建立完目錄后接下來,我們把haosoft_php_module.so移動到剛剛的目錄里去:

 

[ext]# mv haosoft_php_module/haosoft_php_module.so /usr/local/php/lib/php/extensions/no-debug-non-zts-20041030

 

OK!我們可以測試剛建立的模塊了,目前模塊里只有一個haosoft_test()的無參數方法。建立PHP文件test.php:

 

<?php
// 加載剛建立的模塊
dl("haosoft_php_module.so");
// 調用函數
haosoft_test();
?>

 

執行。 看到顯示“This is my module !”了嗎?

 

五、好了,模塊編譯並測試無誤后,我們可以將他編譯進PHP了,回到PHP源代碼包根目錄,執行:

 

[php-5.0.6]#./buildconf --force
[php-5.0.6]#./configure --enable-haosoft_php_module ... 也許你還有其他選項
[php-5.0.6]#make
[php-5.0.6]#make install
[php-5.0.6]#sh /etc/init.d/httpd restart ... 這里是重啟 apache

 

本示例在我PHP 5.0.6上編譯通過。下一章我們再詳細分析haosoft_php_module.h和haosoft_php_module.c這兩個文件里的內容,以及有參數、有返回值函數的定義及使用。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM