首页 > 代码库 > PHP 扩展开发小结
PHP 扩展开发小结
1.变量操作 设置变量 ZVAL_*系列函数; 例: zval t; ZVAL_STRING(t,"10",2); 获取变量 Z_* 系列函数 获取变量指针 Z_*_P 系列函数 获取变量指针的指针 Z_*_PP 系列函数 例: Z_STRVAL(t); Z_STRLEN(t); 变量类型转换 convert_to_* 系列函数 例: convert_to_long_ex(t); 获取变量类型 Z_TYPE Z_TYPE_P Z_TYPE_PP 可以同 IS_* 系列常量对比 例: if(Z_TYPE_P(filehandle)!=IS_LONG) php_printf("this is long type!"); 申请变量的内存 一般 ALLOC_ZVAL(zv) ,MAKE_STD_ZVAL(zv)宏,用完释放 FREE_ZVAL(zv)等宏 释放变量内存 zval_dtor(zval) zval_ptr_dtor(&zval); FREE_ZVAL(zval); 注意:FREE_ZVAL 只释放zval结构体内存,而zval_dtor会释放zval变量及value指针内存 打印变量 php_printf("hi function!"); 返回输出流,可以使用 php_write() 继续写 字符串变量生成函数 spprintf(char **pbuf, size_t max_len, const char *format, ...); 用完释放efree(); 申请内存并复制字符串的副本 estrdup(&a) estrndup(&a,10); 变量内存申请:emalloc(size) efree(ptr) 不要用malloc 除非你能明确释放掉 2.全局变量辅助宏: EG(v);//全局变量 executor_globals 如$_GLOBALS[EG(symbol_table),地址:EG(active_symbol_table) PG(v);//核心变量 php_core_globals 如:$_GET $_POST .. PG(http_globals)[TRACK_VARS_*],INI信息 SG(v);//SAPI变量 请求数据 sapi_globals_struct 如:HTTP原始请求变量 sapi_request_info CG(v);//编译变量 compiler_globals 可以得到函数表,类表 EX(v);//当前执行数据 zend_execute_data 可以获取到当前执行的函数,类,OPCODE等 OG(v);//输出变量 output_globals 3.函数,分5类 ZEND_*_FUNCTION 以下为C定义内置函数 函数参数说明 FOR C: int ht, zval *return_value, zval **return_value_ptr, zval *this_ptr, int return_value_used ht 参数个数,但不能直接使用,该用 ZEND_NUM_ARGS()获取 return_value 函数返回zval return_value_ptr 返回值的指针,但想控制返回值的内容,不是直接返回返回值时候用到,如参数引用实现. this_ptr 如果当前方法是一个对象的方法,此值指向该方法指向的对象,不能直接使用,使用 getThis() 函数 return_value_used 返回值有没有被使用 例: int argc = ZEND_NUM_ARGS(); char *str=NULL; int strlen; //注意:字符串参数为指针的指针 长度为整形的指针 if (zend_parse_parameters(argc TSRMLS_CC, "s|s",&str,&strlen) ==FAILURE) { return; } 关于返回 修改 return_value_ptr 指针指向要用ALLOC_ZVAL_*宏申请内存, 参考:http://www.walu.cc/phpbook/6.1.md 返回的宏 RETURN_*系列函数,资源用 ZEND_REGISTER_RESOURCE RETURN_ZVAL(); 返回zval结构 如果是申请的内存,RETURN_ZVAL(zv, copy, dtor) copy 0 dtor 0 如果是堆栈内存 RETURN_ZVAL(zv, copy, dtor) copy 1 dtor 04.数组与HASH表 1. zvalue_value 是个union 数组时为 hashtable 2. hashtable 表有很对对应的处理函数:zend_hash_*系列函数 3. 数组上的HASHTABLE一般不直接操作,通过add_*系列函数处理 4. hashtable 内存申请 ALLOC_HASHTABLE 等宏处理,用完释放FREE_HASHTABLE 5. 数组初始化也不要用直接处理hashtable,使用 array_init 处理5.资源变量 1. 需要使用资源变量须先得到一个资源列表 参数:1.请求资源,每次请求会清空此请求的资源列表 2.永久资源,服务启动后永久保存 3.显示资源名 4.内部管理参数,忽略 le_myfile = zend_register_list_destructors_ex(myfile_dtor,NULL,"standard-c-file", module_number); static void myfile_dtor(zend_rsrc_list_entry *rsrc TSRMLS_DC){ FILE *fp = (FILE *) rsrc->ptr;//转换指定类型,方便以后操作 fclose(fp); } 2. 把资源注册进资源列表,并设置return_value int r=ZEND_REGISTER_RESOURCE(return_value, fp, le_myfile); 3. 查询资源 filehandle 为资源zval ZEND_FETCH_RESOURCE(fp, FILE *, &filehandle, -1, "standard-c-file",le_myfile); if (fp == NULL){ RETURN_FALSE; } 4.删除资源 filehandle 为资源zval if (zend_list_delete(Z_RESVAL_P(filehandle)) == FAILURE) { RETURN_FALSE; } 5.全局函数 zend_function_entry test_functions[] = { //参数 : 函数名 ZEND_FE(myecho, NULL) {NULL, NULL, NULL} }; 注册到模块中 zend_module_entry php_test_module_entry = { #if ZEND_MODULE_API_NO >= 20010901 STANDARD_MODULE_HEADER, #endif "my test ext",//模块名 test_functions,//函数列表 NULL, NULL, NULL, NULL, PHP_MINFO(php_test),//模块介绍 #if ZEND_MODULE_API_NO >= 20010901 "1.6.0", //版本 #endif STANDARD_MODULE_PROPERTIES }; //函数实现,参考 3.函数部分 PHP_FUNCTION(myecho){} 用户函数调用: 参数: function_table 函数表,全局从&CG(function_table)得到 对象,如果该函数是对象的方法,没有传NULL 函数名 返回值存储 zval指针, 参数数量 参数数组 call_user_function(HashTable *function_table, zval **object_pp, zval *function_name, zval *retval_ptr, zend_uint param_count, zval *params[] TSRMLS_DC); 6.类的实现,结构:zend_class_entry 分两种 ZEND_INTERNAL_CLASS 和 ZEND_USER_CLASS //访问权限控制:ZEND_ACC_*系列宏 //类方法定义 //参数:类名 方法名 ZEND_METHOD( myclass , public_method ) { php_printf("hi function!"); } //注册到函数列表 static zend_function_entry myclass_method[]={ //参数:类名 方法名 静态方法加 ZEND_ACC_STATIC ZEND_ME(myclass, public_method, NULL, ZEND_ACC_PUBLIC) {NULL,NULL,NULL} }; zend_class_entry ce; zend_class_entry *myclass_ce; //参数:初始结构 类名 方法列表 INIT_CLASS_ENTRY(ce,"myclass",myclass_method); //此方法会根据ce拷贝生成一个zend_class_entry并挂载到类列表中 zend_register_internal_class(&ce TSRMLS_CC); //添加类的属性 //参数:类指针 属性名 属性名长度 属性访问权限 : zend_declare_property_* 系列函数 zend_declare_property_null(myclass_ce, "public_var", strlen("public_var"), ZEND_ACC_PUBLIC TSRMLS_CC); //定义类常量: //参数:类指针 属性名 属性名长度 属性访问权限 : zend_declare_class_constant* 系列函数 zend_declare_class_constant_null(myclass_ce, "aaa", 3 TSRMLS_DC); 读取类静态属性 ZEND_API zval *zend_read_static_property( zend_class_entry *scope, char *name, int name_length, //属性不存在是否抛出 notice zend_bool silent TSRMLS_DC ); 更新类静态属性 ZEND_API int zend_update_static_property( zend_class_entry *scope, char *name, int name_length, zval *value TSRMLS_DC ); 其他封装的快捷函数 zend_update_static_property_* 7.接口 结构也是: zend_class_entry static zend_function_entry i_myinterface_method[]={ //注意这里的null指的是arg_info,具体可以参考:参数 arg_info 的定义 ZEND_ABSTRACT_ME(i_myinterface, hello, NULL) {NULL,NULL,NULL} }; //定义及初始化 zend_class_entry ce; INIT_CLASS_ENTRY(ce, "i_myinterface", i_myinterface_method); i_myinterface_ce = zend_register_internal_interface(&ce TSRMLS_CC);8.继承及接口实现 1.实现接口: 写完类,接口后添加: 参数: 类指针 ,实现接口数量,接口指针... zend_class_implements(class_ce TSRMLS_CC,1,myinterface_ce); 2.实现继承: 注册类时候使用: zend_register_internal_class_ex 参数: 类指针 父类指针 父类名 myclass_ce = zend_register_internal_class_ex(&ce,parent_class_ce,"parent_class" TSRMLS_CC);8.对象 zend_object_value 结构: typedef struct _zend_object_value { //unsigned int类型,EG(objects_store).object_buckets的索引 zend_object_handle handle; zend_object_handlers *handlers; } zend_object_value; 创建对象: zval *obj; MAKE_STD_ZVAL(obj); object_init_ex(obj, zend_class_entry 类名 ); //object_init(obj) 空对象 读取属性: ZEND_API zval *zend_read_property( zend_class_entry *scope, zval *object, char *name, int name_length, //属性不存在是否抛出 notice zend_bool silent TSRMLS_DC ); 更新属性: ZEND_API int zend_update_static_property( zend_class_entry *scope, char *name, int name_length, zval *value TSRMLS_DC ); 其他封装的快捷函数 zend_update_property_* 调用方法: ZEND_API zval* zend_call_method(zval **object_pp, zend_class_entry *obj_ce, zend_function **fn_proxy, const char *function_name, int function_name_len, zval **retval_ptr_ptr, int param_count, zval* arg1, zval* arg2 TSRMLS_DC); zend_call_method_with_0_params(obj, obj_ce, fn_proxy, function_name, retval) zend_call_method_with_1_params(&this_zval,myclass_ce,NULL,"hello",NULL);9.常用结构及宏解释: PHP_FN(name) 函数名生成 PHP_MN(name) 方法名生成 ZEND_NAMED_FUNCTION(name) 生成指定名的函数 一般用 PHP_FUNCTION(name) 函数声明 ZEND_METHOD(classname, name) 类方法声明 zend_function_entry 数组用于声明模块或类的成员函数情况 生成zend_function_entry的元素配套宏: //注册全局的函数 //参数:函数名 参数 PHP_FE(name, arg_info) //注册类的函数 //参数:类名 方法名 参数 访问权限控制 PHP_ME(classname, name, arg_info, flags) //注册类的抽象函数,类和接口都用这个 //参数:类名 方法名 参数 PHP_ABSTRACT_ME(classname, name, arg_info) 10.参数 arg_info 的定义 一般情况下不需要定义参数,除非你希望PHP般你检查参数正确性,比如接口方法 生成arg_info的宏,以arg_say_hello为例: //参数:zend_arg_info 名,参数至少前N个 ZEND_BEGIN_ARG_INFO(arg_say_hello, 0) //参数:是否设置为引用,参数名 //ZEND_ARG_* 系列函数还可以声明对象等 ZEND_ARG_INFO(0, name) ZEND_END_ARG_INFO() //其他介绍 //name 参数名称 //name_len 参数名称字符串长度 //class_name 当参数类型为类时,指定类名称 //class_name_len 类名称字符串长度 //array_type_hint 标识参数类型是否为数组 //allow_null 是否允许设置为空 //pass_by_ref 是否设置为引用,即使用&操作符 //return_reference 标识函数将重写return_value_ptr,后面介绍函数返回值时再做介绍 //required_num_args 设置函数被调用时,传递参数至少为前N个,当设置为-1时,必须传递所有参数
PHP 扩展开发小结
声明:以上内容来自用户投稿及互联网公开渠道收集整理发布,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任,若内容有误或涉及侵权可进行投诉: 投诉/举报 工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。