自己動手用 C 擴展 PHP(一)環境要求: Linux, GCC
首先,我們應該選擇如何去構建我們的擴展模塊, 有三種方式:
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 核心裏實現
首先,我們應該選擇如何去構建我們的擴展模塊, 有三種方式:
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 核心裏實現
Note: 本人推薦用 第 2 種方式,直接編譯進PHP, 但是在下面示例裏,我們編譯成外部模塊,因爲,外部模塊不需要重新編譯 PHP,所以在測試階段先編譯成共享庫,然後用dl()加載(不過記得在php.ini裏將安全模式設爲 Off),測試完後再用第2種方式重新編譯進PHP.
1. 首先下載 PHP 源代碼, 解壓。 然後我們開始構建代碼結構,可以利用 PHP 源代碼包ext目錄裏提供的 ext_skel 程序去生成我們需要的結構.
1. 首先下載 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 等幾個文件。
2. haosoft_php_module.h 爲模塊的頭文件(熟悉C語言的應該瞭解), 用 VI 打開,刪除其中的一行:PHP_FUNCTION(confirm_MyExt_compiled); /* For testing, remove later. */
改爲:PHP_FUNCTION(haosoft_test); /* For testing, remove later. */
說明:PHP_FUNCTION() 是一個 Zend Macro,作用是聲名一個 C 函數,使他在 PHP 腳本里可用, 參數是函數的名字,我們這裏的示例函數爲 haosoft_test.
3. haosoft_php_module.c 爲主文件,裏面包含了實現, VI 打開,我們刪除掉
PHP_FUNCTION(confirm_MyExt_compiled){ char *arg = NULL;
這樣會在ext下生成一個 haosoft_php_module 目錄。
目錄裏有 config.m4, haosoft_php_module.h, haosoft_php_module.c 等幾個文件。
2. haosoft_php_module.h 爲模塊的頭文件(熟悉C語言的應該瞭解), 用 VI 打開,刪除其中的一行:PHP_FUNCTION(confirm_MyExt_compiled); /* For testing, remove later. */
改爲:PHP_FUNCTION(haosoft_test); /* For testing, remove later. */
說明:PHP_FUNCTION() 是一個 Zend Macro,作用是聲名一個 C 函數,使他在 PHP 腳本里可用, 參數是函數的名字,我們這裏的示例函數爲 haosoft_test.
3. 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 !");}
4. 現在,我們開始編譯我們的模塊,因爲要編譯成 so,我們選擇手工編譯。
進入 ext 目錄:
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 !");}
4. 現在,我們開始編譯我們的模塊,因爲要編譯成 so,我們選擇手工編譯。
進入 ext 目錄:
開始編譯,編譯成*.o對象文件,注意這個"-DCOMPILE_DL_HAOSOFT_PHP_MODULE",
在 haosoft_php_module.c 裏你可以找到下面的語句
在 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 <? 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 !" 了嗎?
5. 好了,模塊編譯,並測試無誤後,我們可以將他編譯進 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本示例在我 PHP5.0.6 上編譯通過, 下一章我們再詳細分析 haosoft_php_module.h, haosoft_php_module.c 這兩個文件裏的內容,以及有參數,有返回值函數的定義及使用.
4 點了,偶該睡覺了! 有時間再寫下一章。 希望以上內容對大家會有所幫助!
HAOSOFT_PHP_MODULE 是大寫模塊名,你可以換成其他名,但是必須保證這個預處理常量與
上面的語句裏一致,至於上面語句的 ZEND_GET_MODULE(haosoft_php_module) 我們將在下一篇文章講解它的意思.
[ext]# cc -fpic -DCOMPILE_DL_HAOSOFT_PHP_MODULE=1 -I/usr/local/include -
執行完之後會在 目錄下生成一個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 <? 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 !" 了嗎?
5. 好了,模塊編譯,並測試無誤後,我們可以將他編譯進 PHP 了,回到 PHP源代碼包根目錄
執行:[php-
[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本示例在我 PHP5.0.6 上編譯通過, 下一章我們再詳細分析 haosoft_php_module.h, haosoft_php_module.c 這兩個文件裏的內容,以及有參數,有返回值函數的定義及使用.
4 點了,偶該睡覺了! 有時間再寫下一章。 希望以上內容對大家會有所幫助!