1. 1. 变量操作(常量)
  2.     设置变量 ZVAL_*系列函数;
  3.         例:
  4.         zval t;
  5.         ZVAL_STRING(t,"10",2);
  6.     获取变量 Z_* 系列函数
  7.     获取变量指针 Z_*_P 系列函数
  8.     获取变量指针的指针 Z_*_PP 系列函数
  9.         例:
  10.         Z_STRVAL(t);
  11.         Z_STRLEN(t);
  12.     变量类型转换 convert_to_* 系列函数
  13.         例:
  14.         convert_to_long_ex(t);
  15.     获取变量类型 Z_TYPE Z_TYPE_P Z_TYPE_PP 可以同 IS_* 系列常量对比
  16.         例:
  17.         if(Z_TYPE_P(filehandle)!=IS_LONG)
  18.             php_printf("this is long type!");
  19.     申请变量的内存  一般 ALLOC_ZVAL(zv) ,MAKE_STD_ZVAL(zv)宏,用完释放 FREE_ZVAL(zv)等宏
  20.     释放变量内存 zval_dtor(zval)  zval_ptr_dtor(&zval); FREE_ZVAL(zval);
  21.         注意:FREE_ZVAL 只释放zval结构体内存,而zval_dtor会释放zval变量及value指针内存
  22.     打印普通变量 php_printf("hi function!"); 返回输出流,可以使用 PHPWRITE(str, str_len) 继续写
  23.     打印zval变量 
  24.         php_var_dump(zval **struc, int level TSRMLS_DC); var_dump C实现 在:ext/standard/php_var.h
  25.         zend_print_zval_r(zval *expr, int indent TSRMLS_DC) print_r C实现 在Zend核心里
  26.     字符串变量生成函数 spprintf(char **pbuf, size_t max_len, const char *format, ...); 用完释放efree();
  27.     申请内存并复制字符串的副本 estrdup(&a) estrndup(&a,10);
  28.     变量内存申请:emalloc(size) efree(ptr) 不要用malloc 除非你能明确释放掉
  29.     定义常量:REGISTER_*_CONSTANT(name, str, flags)系列函数 flags CONST_* 系列宏
  30.     复制变量 :MAKE_COPY_ZVAL(ppzv, pzv) 申请内存并复制 COPY_PZVAL_TO_ZVAL 复制一个zval指向同类型的zval
  31. 2. 全局C变量辅助宏:
  32.     EG(v);//全局变量 executor_globals 如$_GLOBALS[EG(symbol_table),地址:EG(active_symbol_table)
  33.     PG(v);//核心变量 php_core_globals 如:$_GET $_POST .. PG(http_globals)[TRACK_VARS_*],INI信息
  34.     SG(v);//SAPI变量 请求数据 sapi_globals_struct 如:HTTP原始请求变量 sapi_request_info
  35.     CG(v);//编译变量 compiler_globals 可以得到函数表,类表
  36.     EX(v);//当前执行数据 zend_execute_data 可以获取到当前执行的函数,类,OPCODE等
  37.     OG(v);//输出变量 output_globals 
  38.     
  39. 3. 函数,分5类 ZEND_*_FUNCTION 以下为C定义内置函数
  40.     函数参数说明 FOR C:
  41.         int ht, zval *return_value, zval **return_value_ptr, zval *this_ptr, int return_value_used 
  42.         ht 参数个数,但不能直接使用,该用 ZEND_NUM_ARGS()获取
  43.         return_value 函数返回zval
  44.         return_value_ptr 返回值的指针,但想控制返回值的内容,不是直接返回返回值时候用到,如参数引用实现.
  45.         this_ptr 如果当前方法是一个对象的方法,此值指向该方法指向的对象,不能直接使用,使用 getThis() 函数
  46.         return_value_used 返回值有没有被使用
  47.         例:
  48.         int argc = ZEND_NUM_ARGS();
  49.         char *str=NULL;
  50.         int strlen;
  51.         //次方法用于获取函数参数
  52.         //注意: O 参数须 &object zval 指针 和指明 zend_class_entry * 的指针
  53.         //      s 参数需要 &str char * 指针 和 &strlen int 长度指针
  54.         if (zend_parse_parameters(argc TSRMLS_CC, "s|s",&str,&strlen) ==FAILURE) {
  55.           return;
  56.         }
  57.         //此方法一般用于类的静态方法,当函数映射类方法的时候.
  58.         //会校验getThis()的类和object是否一个类zend_class_entry
  59.         if (zend_parse_method_parameters(ZEND_NUM_ARGS() TSRMLS_CC, getThis(), "Os", &object, date_ce_date,&str,&strlen) == FAILURE) {
  60.             RETURN_FALSE;
  61.         }
  62.     关于返回
  63.         修改 return_value_ptr 指针指向要用ALLOC_ZVAL_*宏申请内存,
  64.         参考:http://www.walu.cc/phpbook/6.1.md
  65.         返回的宏 RETURN_*系列函数,资源用 ZEND_REGISTER_RESOURCE 
  66.         RETURN_ZVAL(); 返回zval结构
  67.             如果是申请的内存,RETURN_ZVAL(zv, copy, dtor) copy 0 dtor 0
  68.             如果是堆栈内存 RETURN_ZVAL(zv, copy, dtor) copy 1 dtor 0
  70. 4. 数组与HASH表
  71.     1. zvalue_value 是个union 数组时为 hashtable
  72.     2. hashtable 表有很对对应的处理函数:zend_hash_*系列函数
  73.     3. 数组上的HASHTABLE一般不直接操作,通过add_*系列函数处理
  74.     4. hashtable 内存申请 ALLOC_HASHTABLE 等宏处理,用完释放FREE_HASHTABLE
  75.     5. 数组初始化也不要用直接处理hashtable,使用 array_init 处理
  77. 5. 资源变量
  78.     1. 需要使用资源变量须先得到一个资源列表
  79.     参数:1.请求资源,每次请求会清空此请求的资源列表
  80.          2.永久资源,服务启动后永久保存
  81.          3.显示资源名
  82.          4.内部管理参数,忽略
  83.     le_myfile = zend_register_list_destructors_ex(myfile_dtor,NULL,"standard-c-file", module_number);
  84.     static void myfile_dtor(zend_rsrc_list_entry *rsrc TSRMLS_DC){
  85.          FILE *fp = (FILE *) rsrc->ptr;//转换指定类型,方便以后操作
  86.          fclose(fp);
  87.     }
  88.     2. 把资源注册进资源列表,并设置return_value
  89.     int r=ZEND_REGISTER_RESOURCE(return_value, fp, le_myfile);
  90.     3. 查询资源
  91.     filehandle 为资源zval 
  92.     ZEND_FETCH_RESOURCE(fp, FILE *, &filehandle, -1, "standard-c-file",le_myfile);
  93.     if (fp == NULL){
  94.       RETURN_FALSE;
  95.     }
  96.     4.删除资源
  97.     filehandle 为资源zval 
  98.     if (zend_list_delete(Z_RESVAL_P(filehandle)) == FAILURE) {
  99.         RETURN_FALSE;
  100.     }
  101.      
  102. 6. 全局函数
  103.     zend_function_entry test_functions[] =
  104.     {
  105.         //参数 : 函数名 
  106.         ZEND_FE(myecho, NULL)
  107.         ZEND_FE_END
  108.     };
  109.     注册到模块中
  110.     zend_module_entry php_test_module_entry = {
  111.     #if ZEND_MODULE_API_NO >= 20010901
  112.         STANDARD_MODULE_HEADER,
  113.     #endif
  114.         "my test ext",//模块名
  115.         test_functions,//函数列表
  116.         NULL,
  117.         NULL,
  118.         NULL,
  119.         NULL,
  120.         PHP_MINFO(php_test),//模块介绍
  121.     #if ZEND_MODULE_API_NO >= 20010901
  122.         "1.6.0", //版本
  123.     #endif
  124.         STANDARD_MODULE_PROPERTIES
  125.     };
  126.     //函数实现,参考 3.函数部分
  127.     PHP_FUNCTION(myecho){}
  128.     用户函数调用:
  129.     参数:
  130.         function_table 函数表,全局从&CG(function_table)得到
  131.         对象,如果该函数是对象的方法,没有传NULL
  132.         函数名
  133.         返回值存储 zval指针,
  134.         参数数量
  135.         参数数组
  136.     call_user_function(HashTable *function_table, zval **object_pp, zval *function_name, zval *retval_ptr, zend_uint param_count, zval *params[] TSRMLS_DC);
  137.      
  138. 7. 类的实现,结构:zend_class_entry 分两种 ZEND_INTERNAL_CLASS 和 ZEND_USER_CLASS
  139.     //访问权限控制:ZEND_ACC_*系列宏
  140.     //类方法定义
  141.     //参数:类名 方法名 
  142.     ZEND_METHOD( myclass , public_method )
  143.     {
  144.         //获取参数方法,参考:3.函数 部分
  145.         if (zend_parse_method_parameters(ZEND_NUM_ARGS() TSRMLS_CC, getThis(), "s", &str,&strlen) == FAILURE) {
  146.             RETURN_FALSE;
  147.         }
  148.         php_printf("hi function!");
  149.     }
  150.     //注册到函数列表
  151.     static zend_function_entry myclass_method[]={
  152.         //参数:类名 方法名 静态方法加 ZEND_ACC_STATIC
  153.         ZEND_ME(myclass,    public_method,    NULL,    ZEND_ACC_PUBLIC)
  154.         {NULL,NULL,NULL}
  155.     };
  156.     zend_class_entry ce;
  157.     zend_class_entry *myclass_ce;
  158.     //参数:初始结构 类名 方法列表
  159.     INIT_CLASS_ENTRY(ce,"myclass",myclass_method);
  160.     //此方法会根据ce拷贝生成一个zend_class_entry并挂载到类列表中
  161.     zend_register_internal_class(&ce TSRMLS_CC);
  162.     //添加类的属性
  163.     //参数:类指针 属性名 属性名长度 属性访问权限 : zend_declare_property_* 系列函数
  164.     zend_declare_property_null(myclass_ce, "public_var", strlen("public_var"), ZEND_ACC_PUBLIC TSRMLS_CC);
  165.     
  166.     //定义类常量:
  167.     //参数:类指针 属性名 属性名长度 属性访问权限 : zend_declare_class_constant* 系列函数
  168.     zend_declare_class_constant_null(myclass_ce, "aaa", 3 TSRMLS_DC);
  169.     
  170.     读取类静态属性
  171.         ZEND_API zval *zend_read_static_property(
  172.             zend_class_entry *scope, 
  173.             char *name, 
  174.             int name_length, 
  175.             //属性不存在是否抛出 notice
  176.             zend_bool silent TSRMLS_DC
  177.         );
  178.     更新类静态属性
  179.         ZEND_API int zend_update_static_property(
  180.             zend_class_entry *scope, 
  181.             char *name, 
  182.             int name_length, 
  183.             zval *value TSRMLS_DC
  184.         );
  185.     其他封装的快捷函数 zend_update_static_property_*
  186.     
  188. 8. 接口 结构也是: zend_class_entry
  189.     static zend_function_entry i_myinterface_method[]={
  190.         //注意这里的null指的是arg_info,具体可以参考:参数 arg_info 的定义
  191.         ZEND_ABSTRACT_ME(i_myinterface, hello, NULL) 
  192.         ZEND_FE_END
  193.     };
  194.     //定义及初始化
  195.     zend_class_entry ce;
  196.     INIT_CLASS_ENTRY(ce, "i_myinterface", i_myinterface_method);
  197.     i_myinterface_ce = zend_register_internal_interface(&ce TSRMLS_CC);
  199. 9. 继承及接口实现
  200.     1.实现接口:
  201.         写完类,接口后添加:
  202.         参数: 类指针 ,实现接口数量,接口指针...
  203.         zend_class_implements(class_ce TSRMLS_CC,1,myinterface_ce);
  204.     2.实现继承:
  205.         注册类时候使用: zend_register_internal_class_ex
  206.         参数: 类指针 父类指针 父类名
  207.         myclass_ce = zend_register_internal_class_ex(&ce,parent_class_ce,"parent_class" TSRMLS_CC);
  209. 10. 对象 zend_object_value
  210.     结构:
  211.     typedef struct _zend_object_value {
  212.         //unsigned int类型，EG(objects_store).object_buckets的索引
  213.         zend_object_handle handle;
  214.         zend_object_handlers *handlers;
  215.     } zend_object_value;
  216.     创建对象:
  217.     zval *obj;
  218.     MAKE_STD_ZVAL(obj);
  219.     object_init_ex(obj, zend_class_entry 类名 );
  220.     //object_init(obj) 空对象
  221.     读取属性:
  222.     ZEND_API zval *zend_read_property(
  223.         zend_class_entry *scope, 
  224.         zval *object, 
  225.         char *name, 
  226.         int name_length, 
  227.         //属性不存在是否抛出 notice
  228.         zend_bool silent TSRMLS_DC
  229.     );
  230.     更新属性:
  231.     ZEND_API int zend_update_static_property(
  232.         zend_class_entry *scope, 
  233.         char *name, 
  234.         int name_length, 
  235.         zval *value TSRMLS_DC
  236.     );
  237.     其他封装的快捷函数 zend_update_property_*
  238.     调用方法:
  239.         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);
  240.         zend_call_method_with_0_params(obj, obj_ce, fn_proxy, function_name, retval)
  241.         zend_call_method_with_1_params(&this_zval,myclass_ce,NULL,"hello",NULL);
  243. 11. 常用结构及宏解释:
  244.     PHP_FN(name) 函数名生成
  245.     PHP_MN(name) 方法名生成
  246.     ZEND_NAMED_FUNCTION(name) 生成指定名的函数 一般用
  247.     PHP_FUNCTION(name) 函数声明
  248.     ZEND_METHOD(classname, name) 类方法声明
  249.     
  250.     zend_function_entry    数组用于声明模块或类的成员函数情况
  251.     生成zend_function_entry的元素配套宏:
  252.         //注册全局的函数
  253.         //参数:函数名 参数
  254.         PHP_FE(name, arg_info) 
  255.         //注册类的函数
  256.         //参数:类名 方法名 参数 访问权限控制
  257.         PHP_ME(classname, name, arg_info, flags) 
  258.         //映射一个函数为类的方法
  259.         //参数:方法名 函数名 参数 访问权限控制 
  260.         //用此宏须在函数体内进行类校验,zend_parse_method_parameters 
  261.         //调用时会把当前对象作为第一个参数传递给函数
  262.         PHP_ME_MAPPING(name, func_name, arg_types, flags)
  263.         //注册类的抽象函数,类和接口都用这个
  264.         //参数:类名 方法名 参数
  265.         PHP_ABSTRACT_ME(classname, name, arg_info) 
  266.         //结束标记
  267.         PHP_FE_END
  268.         
  269. 12. 参数 arg_info 的定义
  270.     一般情况下不需要定义参数,除非你希望PHP般你检查参数正确性,比如接口方法
  271.     生成arg_info的宏,以arg_say_hello为例:
  272.     //参数:zend_arg_info 名,参数至少前N个
  273.     ZEND_BEGIN_ARG_INFO(arg_say_hello, 0)
  274.     //参数:是否设置为引用,参数名
  275.     //ZEND_ARG_* 系列函数还可以声明对象等
  276.     ZEND_ARG_INFO(0, name)
  277.     ZEND_END_ARG_INFO()
  278.     //其他介绍
  279.     //name    参数名称
  280.     //name_len    参数名称字符串长度
  281.     //class_name    当参数类型为类时，指定类名称
  282.     //class_name_len    类名称字符串长度
  283.     //array_type_hint    标识参数类型是否为数组
  284.     //allow_null    是否允许设置为空
  285.     //pass_by_ref    是否设置为引用，即使用&操作符
  286.     //return_reference    标识函数将重写return_value_ptr，后面介绍函数返回值时再做介绍
  287.     //required_num_args    设置函数被调用时，传递参数至少为前N个，当设置为-1时，必须传递所有参数
  288.     
  289. 13. 目录结构
  290.     ext/ 扩展
  291.     ext/standard PHP内置函数
  292.     Zend/ PHP核心
  293.     Zend/zend_builtin_functions.c 核心函数 还有常用的辅助函数
  294.     sapi/ sapi接口实现
  295.     main/ 对外编写接口
  297. 14. 流程及扩展备注
  298.     zend_module_entry php_test_module_entry = {
  299.         STANDARD_MODULE_HEADER,
  300.         "my test ext",                /* 模块名称 */
  301.         test_functions,                /* 模块函数 */
  302.         PHP_MINIT(test),            /* 模块启动 */
  303.         PHP_MSHUTDOWN(test),        /* 模块关闭 */
  304.         PHP_RINIT(test),            /* 请求开始 */
  305.         PHP_RSHUTDOWN(test),        /* 请求完成 */
  306.         PHP_MINFO(php_test),        /* 模块信息 */
  307.         "1.6.0",                     /* 模块版本 */
  308.         //还可以增加全局变量注册部分,参考:16.全局变量
  309.         STANDARD_MODULE_PROPERTIES
  310.     };
  311.     ZEND_GET_MODULE(php_test);
  312.     PHP_MINIT_FUNCTION(test)
  313.     {
  314.         //此阶段注册类等
  315.         //注册INI
  316.         //REGISTER_INI_ENTRIES();
  317.         return SUCCESS;
  318.     }
  319.     PHP_RINIT_FUNCTION(test){
  320.         return SUCCESS;
  321.     }
  322.     PHP_RSHUTDOWN_FUNCTION(test){
  323.         return SUCCESS;
  324.     }
  325.     PHP_MSHUTDOWN_FUNCTION(test)
  326.     {
  327.         UNREGISTER_INI_ENTRIES();
  328.         return SUCCESS;
  329.     }
  330. 15. 配置设置与获取
  331.     PHP_INI_BEGIN()
  332.         PHP_INI_ENTRY("myini","bbb",PHP_INI_ALL, NULL)
  333.     PHP_INI_END()
  334.     //一般在 PHP_MINIT_FUNCTION 注册
  335.     PHP_MINIT_FUNCTION(test)
  336.     {
  337.         //***
  338.         REGISTER_INI_ENTRIES();
  339.         //***
  340.     }
  341.     获取配置:
  342.     INI_* 系列宏
  344. 16. 线程安全的全局变量,并定义获取方法,类似于:EG(v) PG(v) SG(v) 等实现
  345.    //test 一般为模块名,也可以用其他,用模块名号记忆
       //注意:全局变量不跟随请求,请求完成不会重置.
  346.     ZEND_BEGIN_MODULE_GLOBALS(test)
  347.         int flags;
  348.     ZEND_END_MODULE_GLOBALS(test)
  349.     #ifdef ZTS
  350.     # define YOURGET(v) TSRMG(test_globals_id, zend_test_globals *, v)
  351.     #else
  352.     # define YOURGET(v) (test_globals.v)
  353.     #endif
  354.     //以上为声明部分
  355.     
  356.     //以下为:初始化及注册到PHP内核中
  357.     ZEND_DECLARE_MODULE_GLOBALS(test);
  358.     //全局可用
  359.     //ZEND_EXTERN_MODULE_GLOBALS(test);
  360.     zend_module_entry php_test_module_entry = {
  361.         STANDARD_MODULE_HEADER,
  362.         "my test ext",
  363.         test_functions,
  364.         NULL,
  365.         NULL,
  366.         NULL,
  367.         NULL,
  368.         NULL,
  369.         NO_VERSION_YET,//以下为开启全局变量时增加
  370.         PHP_MODULE_GLOBALS(test),//作用:注册到全局变量中
  371.         PHP_GINIT(test),//全局变量初始化时调用函数,一般为启动PHP时,可为NULL
  372.         PHP_GSHUTDOWN(test),//全局变量销毁时调用函数,一般为关闭PHP时,可为NULL
  373.         NULL,
  374.         STANDARD_MODULE_PROPERTIES_EX //注意:多个EX
  375.     };
  376.     //全局变量注册的回调函数 宏
  377.     static PHP_GINIT_FUNCTION(test)
  378.     {
  379.         test_globals->flags = 0;
  380.     }
  381.     static PHP_GSHUTDOWN_FUNCTION(test)
  382.     {
  383.         //其他操作,如释放申请的内存等
  384.     }
  386. 17. gdb调试扩展
  387.     PHP编译的时候加上 -–enable-debug 参数
  388.     修改config.m4
  389.     if test -z "$PHP_DEBUG" ; then
  390.        AC_ARG_ENABLE(debug,
  391.                [--enable-debug compile with debugging system],
  392.                [PHP_DEBUG=$enableval],[PHP_DEBUG=no]
  393.        )
  394.     fi
  395.     ./configure 的时候加入 –enable-debug
  396.     //设置 core 的大小
  397.     ulimit -c unlimited
  398.     //以下假设php路径在系统的/usr/bin或/usr/local/bin中
  399.     gdb php -c core[core为生成的core文件]
  400.     常用调试命令:
  401.     r 运行
  402.     b 设置断点
  403.     set args 设置参数
  404.     n 运行下一步
  405.     c 继续运行
  406.     p 打印
  407.     watch 当变量修改断点
  408.     list  查看代码
  409.     layout src 显示源码
  410.     layout asm 显示汇编

    gdb 错误: Missing separate debuginfos, use: debuginfo-install 

　　1、需要先修改“/etc/yum.repos.d/CentOS-Debuginfo.repo”文件的enable=1；
　　2、使用 sudo yum install glibc 安装；
　　3、使用 debuginfo-install glibc-2.12-1.132.el6.i686 安装。

  1.  

 

版权声明：本文为liushannet原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://www.cnblogs.com/liushannet/p/4074134.html