php擴展開發對于很多朋友來講都不太可能實現現因為php擴展開發是需要懂c的,下面我來為各位介紹一個　php擴展開發例子吧.

一、自動化建立擴展框架

到源碼ext目錄下,幫助.

./ext_skel --extname=xiami_ext

生成如下幾個文件文件列表:

1. * CREDITS 
2. * EXPERIMENTAL 
3. * config.m4 
4. * config.w32 
5. * php_xiami_ext.h 
6. * tests 
7. * xiami_ext.c 
8. * xiami_ext.php 

.c文件就是C語言系列的源文件,而.h文件則是C語言的頭文件,即C系列中存放函數和全局變量的文件,子程序不要定義在*.h中,函數定義要放在*.c中,而*.h只做聲明.否則多引用幾次,就會發生函數重復定義的錯誤.

二、編寫函數xiami_hello

1、不帶參數

1. php_xiami_ext.h 
2.  
3. PHP_MINIT_FUNCTION(xiami_ext); 
4. PHP_MSHUTDOWN_FUNCTION(xiami_ext); 
5. PHP_RINIT_FUNCTION(xiami_ext); 
6. PHP_RSHUTDOWN_FUNCTION(xiami_ext); 
7. PHP_MINFO_FUNCTION(xiami_ext); 
8.  
9. PHP_FUNCTION(xiami_hello); 
10. xiami_ext.c 
11.  
12. const zend_function_entry xiami_ext_functions[] = { 
13.     ZEND_FE(confirm_xiami_ext_compiled, NULL) 
14.     ZEND_FE(xiami_hello,        NULL) 
15.     PHP_FE_END 
16. }; 
17.  
18. ZEND_FUNCTION(xiami_hello) 
19. { 
20.     php_printf("Hello World!n"); 
21. } 

2、接收外來參數

1. xiami_ext.c 
2.  
3. ZEND_BEGIN_ARG_INFO(arg_xiami_hello, 0) 
4. ZEND_ARG_INFO(0, name) 
5. ZEND_END_ARG_INFO() 
6.  
7. ZEND_FUNCTION(xiami_hello) 
8. { 
9.     char *name = NULL; 
10.     int argc = ZEND_NUM_ARGS(); 
11.     int name_len; 
12.  
13.     if (zend_parse_parameters(argc TSRMLS_CC, "s", &name, &name_len) == FAILURE) 
14.         return; 
15.     php_printf("hello %s",name); 
16. } 
17.  
18. const zend_function_entry xiami_ext_functions[] = { 
19.     ZEND_FE(confirm_xiami_ext_compiled, NULL) 
20.     ZEND_FE(xiami_hello,        arg_xiami_hello) 
21.     PHP_FE_END 
22. }; 

以ZEND_BEGIN_ARG_INFO宏定義開始,以ZEND_END_ARG_INFO()結束,這兩個宏定義解釋如下:

ZEND_BEGIN_ARG_INFO(name, pass_rest_by_reference)：

開始參數塊定義，pass_rest_by_reference為1時,強制所有參數為引用類型

ZEND_END_ARG_INFO()

ZEND_NUM_ARGS()代表著參數的個數:

1. 參數   代表著的類型 
2. b   Boolean 
3. l   Integer 整型 
4. d   Floating point 浮點型 
5. s   String 字符串 
6. r   Resource 資源 
7. a   Array 數組 
8. o   Object instance 對象 
9. O   Object instance of a specified type 特定類型的對象 
10. z   Non-specific zval 任意類型～ 
11. Z   zval**類型 

三、編寫類XiamiClass

1、步驟

1. # 創建一個全局的zend_class_entry變量，用于存儲類的入口。 
2. # 創建一個zend_function_entry結構體數組，用于存儲類中包含的方法。 
3. # 在擴展的MINIT方法中注冊類。 

2、空類

xiami_ext.c

首先,我們創建一個名為php_xiamiclass_entry的zend_class_entry結構體變量,該結構體變量實際存儲了我們創建的類的入口.

zend_class_entry *php_xiamiclass_entry;

這里的php_xiamiclass_entry在擴展源文件中是一個全局變量,為了使其它擴展可以使用我們創建的類,這個全局變量應該在頭文件中定義.

接下來,我們創建zend_function_entry結構體數組,這個數組與函數定義時的數組是一樣的.

1. const zend_function_entry xiami_ext_methods[] = { 
2.     PHP_FE_END 
3. }; 

在MINIT函數中,首先創建了一個xiami_ce變量用于存儲臨時的類入口,接下來使用INIT_CLASS_ENTRY 宏初始化該變量,之后使用zend_register_internal_class()將該類注冊到Zend引擎,該函數會返回一個最終的類入口,將其賦值給前面創建的全局變量.

1. PHP_MINIT_FUNCTION(xiami_ext) 
2. { 
3.     zend_class_entry xiami_ce; 
4.     INIT_CLASS_ENTRY(xiami_ce, "XiamiClass", xiami_ext_methods); 
5.  
6.     php_xiamiclass_entry = zend_register_internal_class(&xiami_ce TSRMLS_CC); 
7.     return SUCCESS; 
8. } 

3、類方法

1. php_xiami_ext.h 
2.  
3. PHP_MINIT_FUNCTION(xiami_ext); 
4. PHP_MSHUTDOWN_FUNCTION(xiami_ext); 
5. PHP_RINIT_FUNCTION(xiami_ext); 
6. PHP_RSHUTDOWN_FUNCTION(xiami_ext); 
7. PHP_MINFO_FUNCTION(xiami_ext); 
8.  
9. PHP_METHOD(XiamiClass,__construct); 
10. PHP_METHOD(XiamiClass, set_xiami_age); 
11. xiami_ext.c 
12.  
13. ZEND_BEGIN_ARG_INFO_EX(arg_construct, 0, 0, 1) 
14.     ZEND_ARG_INFO(0, age) 
15. ZEND_END_ARG_INFO(); 
16.  
17. ZEND_BEGIN_ARG_INFO(arg_xiami_age, 0) 
18.     ZEND_ARG_INFO(0, age) 
19. ZEND_END_ARG_INFO() 
20.  
21. PHP_METHOD(XiamiClass, __construct) 
22. { 
23.     long age; 
24.     if(zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &age) == FAILURE){ 
25.         WRONG_PARAM_COUNT; 
26.     } 
27.     if( age <= 0 ) { 
28.         age = 1; 
29.     } 
30.  
31.     zend_update_property_long(Z_OBJCE_P(getThis()), getThis(), ZEND_STRL("_age"), age TSRMLS_CC); 
32.     RETURN_TRUE; 
33. } 
34.  
35. PHP_METHOD(XiamiClass, set_xiami_age) 
36. { 
37.     long age; 
38.     if(zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &age) == FAILURE){ 
39.         WRONG_PARAM_COUNT; 
40.     } 
41.     if( age <= 0 ) { 
42.         age = 1; 
43.     } 
44.     zend_update_property_long(Z_OBJCE_P(getThis()), getThis(), ZEND_STRL("_age"), age TSRMLS_CC); 
45.     RETURN_TRUE; 
46. } 
47.  
48. PHP_MINIT_FUNCTION(xiami_ext) 
49. { 
50.     zend_class_entry xiami_ce; 
51.     INIT_CLASS_ENTRY(xiami_ce, "XiamiClass", xiami_ext_methods); 
52.  
53.     php_xiamiclass_entry = zend_register_internal_class(&xiami_ce TSRMLS_CC); 
54.  
55.     zend_declare_property_null(php_xiamiclass_entry, ZEND_STRL("_age"), ZEND_ACC_PRIVATE TSRMLS_CC); 
56.     return SUCCESS; 
57. } 
58. zend_declare_property_*系列函數: 
59.  
60. ZEND_API int zend_declare_property_null(zend_class_entry *ce, char *name, int name_length, int access_type TSRMLS_DC); 
61. 用zend_read_property()和zend_update_property()函數： 
62.  
63. ZEND_API zval *zend_read_property(zend_class_entry *scope, zval *object, char *name, int name_length, zend_bool silent TSRMLS_DC); 
64.  
65. ZEND_API void zend_update_property(zend_class_entry *scope, zval *object, char *name, int name_length, zval *value TSRMLS_DC); 

四、讀取ini文件

1. php_xiami_ext.h 
2.  
3. PHP_MINIT_FUNCTION(xiami_ext); 
4. PHP_MSHUTDOWN_FUNCTION(xiami_ext); 
5. PHP_RINIT_FUNCTION(xiami_ext); 
6. PHP_RSHUTDOWN_FUNCTION(xiami_ext); 
7. PHP_MINFO_FUNCTION(xiami_ext); 
8.  
9. PHP_FUNCTION(xiami_hello); 
10. ZEND_BEGIN_MODULE_GLOBALS(xiami_ext) 
11.     long  age; 
12. ZEND_END_MODULE_GLOBALS(xiami_ext) 
13.  
14. #ifdef ZTS 
15. #define XIAMI_EXT_G(v) TSRMG(xiami_ext_globals_id, zend_xiami_ext_globals *, v) 
16. #else 
17. #define XIAMI_EXT_G(v) (xiami_ext_globals.v) 
18. #endif 
19. xiami_ext.c 
20.  
21. ZEND_DECLARE_MODULE_GLOBALS(xiami_ext) 
22.  
23. PHP_INI_BEGIN() 
24.    STD_PHP_INI_ENTRY("xiami_ext.age",      "42", PHP_INI_ALL, OnUpdateLong, age, zend_xiami_ext_globals, xiami_ext_globals) 
25. PHP_INI_END() 
26.  
27. static void php_xiami_ext_init_globals(zend_xiami_ext_globals *xiami_ext_globals) 
28. { 
29.     xiami_ext_globals->age = 10; 
30. } 
31.  
32. PHP_MINIT_FUNCTION(xiami_ext) 
33. { 
34.     ZEND_INIT_MODULE_GLOBALS(xiami_ext, php_xiami_ext_init_globals, NULL); 
35.     REGISTER_INI_ENTRIES(); 
36.  
37.     return SUCCESS; 
38. } 
39.  
40. ZEND_FUNCTION(xiami_hello) 
41. { 
42.     RETURN_LONG(XIAMI_EXT_G(age)); 
43. } 
44.  
45. const zend_function_entry xiami_ext_functions[] = { 
46.     ZEND_FE(xiami_hello,        NULL) 
47.     PHP_FE_END 
48. }; 

STD_PHP_INI_ENTRY的最后三個參數是來告訴PHP修改哪個全局變量,我們擴展的全局變量的數據結構,以及這些全局變量被保存到的全局容器的名稱.

在php_xiami_ext.h添加的內容中,使用了一對宏ZEND_BEGIN_MODULE_GLOBALS()和ZEND_END_MODULE_GLOBALS() — 用來創建一個包含一個age類型,名為zend_xiami_ext_globals的結構體,然后繼續聲明了XIAMI_EXT_G()來從一個線程池中獲取值,或者只是從全局空間中獲取 － 如果你為一個非線程環境編譯的話.

在php_xiami_ext.c中你用了ZEND_DECLARE_MODULE_GLOBALS()宏來真正實例化zend_xiami_ext_globals結構體為一個真正的全局變量.最后,在MINIT中,你使用了ZEND_INIT_MODULE_GLOBALS()來分配一個線程安全的資源id.

phpinfo擴展信息中,顯示ini信息.

1. PHP_MINFO_FUNCTION(xiami_ext) 
2. { 
3.     php_info_print_table_start(); 
4.     php_info_print_table_header(2, "xiami_ext support", "enabled"); 
5.     php_info_print_table_end(); 
6.  
7.     DISPLAY_INI_ENTRIES(); 
8. } 

五、設置常量

1. PHP_MINIT_FUNCTION(ggg) 
2. { 
3.     zend_constant c; 
4.     char *trim_key = "xiami"; 
5.     char *trim_val = "hello"; 
6.     int trim_val_len,trim_key_len; 
7.  
8.     trim_key_len = strlen(trim_key); 
9.     trim_val_len = strlen(trim_val); 
10.  
11.     c.value.type = IS_STRING; 
12.     c.value.value.str.val = pestrdup(trim_val, trim_val_len+1); 
13.     c.value.value.str.len = trim_val_len; 
14.     c.flags = CONST_PERSISTENT | CONST_CS; 
15.     c.name = pestrdup(trim_key, trim_key_len+1); 
16.     c.name_len = trim_key_len+1; 
17.     c.module_number = module_number; 
18.     zend_register_constant(&c TSRMLS_CC); 
19.  
20.     return SUCCESS; 
21. } 

六、資源處理

PHP中的資源類型在內核中是通過一個zend_rsrc_list_entry結構體來實現:

1. typedef struct _zend_rsrc_list_entry { 
2.     void *ptr; 
3.     int type; 
4.     int refcount; 
5. } zend_rsrc_list_entry; 

其中,ptr是一個指向資源的最終實現的指針,例如一個文件句柄,或者一個數據庫連接結構,type是一個類型標記,用于區分不同的資源類型,refcount用于資源的引用計數.

資源類型可分為普通的資源,以及持久型的資源,例如mysql普通連接與持久連接,均保存在_zend_executor_globals結構體當中,其中包含如下兩個HashTable.

1. struct _zend_executor_globals { 
2.     ... 
3.     HashTable regular_list; 
4.     HashTable persistent_list; 
5.     ... 
6. } 

regular_list保存普通資源,persistent_list則保存持久型資源,要使用資源,先要注冊一個資源類型,使用如下的API函數:

1. ZEND_API int zend_register_list_destructors_ex(rsrc_dtor_func_t ld, rsrc_dtor_func_t pld, const char *type_name, int module_number); 

此函數返回一個資源類型id,zend_rsrc_list_entry結構體當中的type成員即對應此值,在擴展當中,此id應作為一個全局變量保存,以傳遞給其它資源API.

函數的第一及第二個參數,分別對應普通資源及持久資源的析構函數,第三個參數為資源類型的簡短名稱描述,一般用于錯誤提示,最后一個參數module_number為引擎內部使用,當我們調用這個函數時,只需要傳遞一個已經定義好的module_number變量.

1. static void myfile_dtor(zend_rsrc_list_entry *rsrc TSRMLS_DC){ 
2.      FILE *fp = (FILE *) rsrc->ptr; 
3.      fclose(fp); 
4. } 
5.  
6. PHP_MINIT_FUNCTION(myfile) { 
7.  
8. //le_myfile是一個用于保存資源類型id的全局變量 
9.      le_myfile = zend_register_list_destructors_ex(myfile_dtor,NULL,"standard-c-file", module_number); 
10.      return SUCCESS; 

要創建一個資源,通過ZEND_REGISTER_RESOURCE()函數:

1. ZEND_API int zend_register_resource(zval *rsrc_result, void *rsrc_pointer, int rsrc_type TSRMLS_DC); 
2. #define ZEND_REGISTER_RESOURCE(rsrc_result, rsrc_pointer, rsrc_type)  zend_register_resource(rsrc_result, rsrc_pointer, rsrc_type TSRMLS_CC); 

其第一個參數rsrc_result是一個指向zval的指針,很顯然其作用是將PHP變量和資源進行綁定.

第二個參數rsrc_pointer是一個指向資源數據的指針.

第三個參數rsrc_type，很顯然,是上面通過zend_register_list_destructors_ex()函數注冊所返回的資源類型id.

1. PHP_FUNCTION(file_open){ 
2.      char *filename = NULL; 
3.      char *mode = NULL; 
4.      int argc = ZEND_NUM_ARGS(); 
5.      int filename_len; 
6.      int mode_len; 
7.      FILE *fp; 
8.  
9.      if (zend_parse_parameters(argc TSRMLS_CC, "ss", &filename,&filename_len, &mode, &mode_len) == FAILURE) { 
10.           return; 
11.      } 
12.  
13.      fp = fopen(filename, mode); 
14.  
15.      if (fp == NULL) { 
16.           RETURN_FALSE; 
17.      } 
18.  
19.      ZEND_REGISTER_RESOURCE(return_value, fp, le_myfile); 
20. } 

要訪問一個資源,是通過ZEND_FETCH_RESOURCE()函數來進行的:

1. ZEND_API void *zend_fetch_resource(zval **passed_id TSRMLS_DC, int default_id, const char *resource_type_name, int *found_resource_type, int num_resource_types, ...); 
2. #define ZEND_VERIFY_RESOURCE(rsrc)  if (!rsrc) { RETURN_FALSE; } 
3. #define ZEND_FETCH_RESOURCE(rsrc, rsrc_type, passed_id, default_id, resource_type_name, resource_type)  rsrc = (rsrc_type) zend_fetch_resource(passed_id TSRMLS_CC, default_id, resource_type_name, NULL, 1, resource_type);    ZEND_VERIFY_RESOURCE(rsrc); 

第一個參數rsrc,是要保存資源值所對應的變量名.

第二個參數,是一個指針轉換的定義,用于內部將資源轉換為正確的類型.

第三個參數,是一個對應的資源值.

第四個參數,用于實現資源的默認值.

第五個參數，同zend_register_list_destructors_ex()的第三個參數.

第六個參數,對應zend_register_list_destructors_ex()的返回值.

1. PHP_FUNCTION(file_write){ 
2.      char *buffer = NULL; 
3.      int argc = ZEND_NUM_ARGS(); 
4.      int buffer_len; 
5.      zval *filehandle = NULL; 
6.      FILE *fp; 
7.  
8.      if (zend_parse_parameters(argc TSRMLS_CC, "rs", &filehandle,&buffer, &buffer_len) == FAILURE) { 
9.           return; 
10.      } 
11.  
12.      ZEND_FETCH_RESOURCE(fp, FILE *, &filehandle, -1, "standard-cfile", le_myfile); 
13.  
14.      if (fwrite(buffer, 1, buffer_len, fp) != buffer_len) { 
15.           RETURN_FALSE; 
16.      } 
17.  
18.      RETURN_TRUE; 
19. } 

要刪除一個資源,則使用zend_list_delete()函數:

1. ZEND_API int _zend_list_delete(int id TSRMLS_DC); 
2. #define zend_list_delete(id)  _zend_list_delete(id TSRMLS_CC) 

這個函數僅有一個資源id的參數,返回SUCCESS或者FAILURE.

1. PHP_FUNCTION(file_close){ 
2.      int argc = ZEND_NUM_ARGS(); 
3.      zval *filehandle = NULL; 
4.  
5.      if (zend_parse_parameters(argc TSRMLS_CC, "r", &filehandle) == FAILURE) { 
6.           return; 
7.      } 
8.  
9.      if (zend_list_delete(Z_RESVAL_P(filehandle)) == FAILURE) { 
10.           RETURN_FALSE; 
11.      } 
12.  
13.      RETURN_TRUE; 
14. }