PHP内核探索：变量的值操作

PHP内核提供了三个基础宏来方便我们对变量的值进行操作，这几个宏同样以Z_开头，并且P结尾和PP结尾的同上一节中的宏一样，分别代表这参数是指针还是指针的指针。此外，为了进一步方便我们的工作，内核中针对具体的数据类型分别定义了相应的宏。如针对IS_BOOL型的BVAL组合(Z_BVAL、Z_BVAL_P、Z_BVAL_PP)和针对IS_DOUBLE的DVAL组合(Z_DVAL、ZDVAL_P、ZDVAL_PP)等等。我们通过下面这个例子来应用一下这几个宏:

01void display_value(zval zv,zval *zv_p,zval **zv_pp)
02{
03    if( Z_TYPE(zv) == IS_NULL )
04    {
05        php_printf("类型是 IS_NULL!\n");
06    }
07     
08    if( Z_TYPE_P(zv_p) == IS_LONG )
09    {
10        php_printf("类型是 IS_LONG，值是：%ld" , Z_LVAL_P(zv_p));
11    }
12     
13    if(Z_TYPE_PP(zv_pp) == IS_DOUBLE )
14    {
15        php_printf("类型是 IS_DOUBLE,值是：%f" , Z_DVAL_PP(zv_pp) );
16    }
17}

String型变量比较特殊，因为内核在保存String型变量时，不仅保存了字符串的值，还保存了它的长度，所以它有对应的两种宏组合STRVAL和STRLEN，即：Z_STRVAL、Z_STRVAL_P、Z_STRVAL_PP与Z_STRLEN、Z_STRLEN_P、Z_STRLEN_PP。前一种宏返回的是char *型，即字符串的地址；后一种返回的是int型，即字符串的长度。

1void display_string(zval *zstr)
2{
3    if (Z_TYPE_P(zstr) != IS_STRING) {
4        php_printf("这个变量不是字符串!\n");
5        return;
6    }
7    PHPWRITE(Z_STRVAL_P(zstr), Z_STRLEN_P(zstr));
8    //这里用了PHPWRITE宏，只要知道它是从Z_STRVAL_P(zstr)地址开始，输出Z_STRLEN_P(zstr)长度的字符就可以了。
9}

Array型变量的值其实是存储在C语言实现的HashTable中的，我们可以用ARRVAL组合宏（Z_ARRVAL, Z_ARRVAL_P, Z_ARRVAL_PP）这三个宏来访问数组的值。如果你看旧版本php的源码或者部分pecl扩展的源码，可能会发现一个HASH_OF()宏，这个宏等价于Z_ARRVAL_P()，但不推荐在新代码中再使用了。

对象是一个复杂的结构体（zend_object_value结构体），不仅存储属性的定义、属性的值，还存储着访问权限、方法等信息。内核中定义了以下组合宏让我们方便的操作对象：OBJ_HANDLE, which returns the handle identifier, OBJ_HT for the handler table, OBJCE for the class definition, OBJPROP for the property HashTable, and OBJ_HANDLER for manipulating a specific handler method in the OBJ_HT table. Don't worry about the meaning of these various object macros just yet; they'll be covered in detail in Chapter 10, "PHP4 Objects," and Chapter 11, "PHP5 Objects."

资源型变量的值其实就是一个整数，可以用RESVAL组合宏来访问它，我们把它的值传给zend_fetch_resource函数，便可以得到这个资源的操作句柄，如mysql的链接句柄等。有关资源的内容我们将在第9章展开叙述。

有关值操作的宏都定义在./Zend/zend_operators.h文件里：

01//操作整数的
02#define Z_LVAL(zval)            (zval).value.lval
03#define Z_LVAL_P(zval_p)        Z_LVAL(*zval_p)
04#define Z_LVAL_PP(zval_pp)      Z_LVAL(**zval_pp)
05 
06//操作IS_BOOL布尔型的
07#define Z_BVAL(zval)            ((zend_bool)(zval).value.lval)
08#define Z_BVAL_P(zval_p)        Z_BVAL(*zval_p)
09#define Z_BVAL_PP(zval_pp)      Z_BVAL(**zval_pp)
10 
11//操作浮点数的
12#define Z_DVAL(zval)            (zval).value.dval
13#define Z_DVAL_P(zval_p)        Z_DVAL(*zval_p)
14#define Z_DVAL_PP(zval_pp)      Z_DVAL(**zval_pp)
15 
16//操作字符串的值和长度的
17#define Z_STRVAL(zval)          (zval).value.str.val
18#define Z_STRVAL_P(zval_p)      Z_STRVAL(*zval_p)
19#define Z_STRVAL_PP(zval_pp)        Z_STRVAL(**zval_pp)
20 
21#define Z_STRLEN(zval)          (zval).value.str.len
22#define Z_STRLEN_P(zval_p)      Z_STRLEN(*zval_p)
23#define Z_STRLEN_PP(zval_pp)        Z_STRLEN(**zval_pp)
24 
25//操作数组的
26#define Z_ARRVAL(zval)          (zval).value.ht
27#define Z_ARRVAL_P(zval_p)      Z_ARRVAL(*zval_p)
28#define Z_ARRVAL_PP(zval_pp)        Z_ARRVAL(**zval_pp)
29 
30//操作对象的
31#define Z_OBJVAL(zval)          (zval).value.obj
32#define Z_OBJVAL_P(zval_p)      Z_OBJVAL(*zval_p)
33#define Z_OBJVAL_PP(zval_pp)        Z_OBJVAL(**zval_pp)
34 
35#define Z_OBJ_HANDLE(zval)      Z_OBJVAL(zval).handle
36#define Z_OBJ_HANDLE_P(zval_p)      Z_OBJ_HANDLE(*zval_p)
37#define Z_OBJ_HANDLE_PP(zval_p)     Z_OBJ_HANDLE(**zval_p)
38 
39#define Z_OBJ_HT(zval)          Z_OBJVAL(zval).handlers
40#define Z_OBJ_HT_P(zval_p)      Z_OBJ_HT(*zval_p)
41#define Z_OBJ_HT_PP(zval_p)     Z_OBJ_HT(**zval_p)
42 
43#define Z_OBJCE(zval)           zend_get_class_entry(&(zval) TSRMLS_CC)
44#define Z_OBJCE_P(zval_p)       Z_OBJCE(*zval_p)
45#define Z_OBJCE_PP(zval_pp)     Z_OBJCE(**zval_pp)
46 
47#define Z_OBJPROP(zval)         Z_OBJ_HT((zval))->get_properties(&(zval) TSRMLS_CC)
48#define Z_OBJPROP_P(zval_p)     Z_OBJPROP(*zval_p)
49#define Z_OBJPROP_PP(zval_pp)       Z_OBJPROP(**zval_pp)
50 
51#define Z_OBJ_HANDLER(zval, hf)     Z_OBJ_HT((zval))->hf
52#define Z_OBJ_HANDLER_P(zval_p, h)  Z_OBJ_HANDLER(*zval_p, h)
53#define Z_OBJ_HANDLER_PP(zval_p, h)     Z_OBJ_HANDLER(**zval_p, h)
54 
55#define Z_OBJDEBUG(zval,is_tmp)     (Z_OBJ_HANDLER((zval),get_debug_info)?  \
56                        Z_OBJ_HANDLER((zval),get_debug_info)(&(zval),&is_tmp TSRMLS_CC): \
57                        (is_tmp=0,Z_OBJ_HANDLER((zval),get_properties)?Z_OBJPROP(zval):NULL))
58#define Z_OBJDEBUG_P(zval_p,is_tmp) Z_OBJDEBUG(*zval_p,is_tmp)
59#define Z_OBJDEBUG_PP(zval_pp,is_tmp)   Z_OBJDEBUG(**zval_pp,is_tmp)
60 
61//操作资源的
62#define Z_RESVAL(zval)          (zval).value.lval
63#define Z_RESVAL_P(zval_p)      Z_RESVAL(*zval_p)
64#define Z_RESVAL_PP(zval_pp)        Z_RESVAL(**zval_pp)

Arthur's Blog

导航

最近发布

友情链接