2.2 变量的值

PHP内核提供了三个基础宏来方便我们对变量的值进行操作,这几个宏同样以Z_开头,并且P结尾和PP结尾的同上一节中的宏一样,分别代表这参数是指针还是指针的指针。

此外,为了进一步方便我们的工作,内核中针对具体的数据类型分别定义了相应的宏。如针对IS_BOOL型的BVAL组合(Z_BVAL、Z_BVAL_P、Z_BVAL_PP)和针对IS_DOUBLE的DVAL组合(Z_DVAL、ZDVAL_P、ZDVAL_PP)等等。我们通过下面这个例子来应用一下这几个宏:

  1. void display_value(zval zv,zval *zv_p,zval **zv_pp)
  2. {
  3. if( Z_TYPE(zv) == IS_NULL )
  4. {
  5. php_printf("类型是 IS_NULL!\n");
  6. }
  7. if( Z_TYPE_P(zv_p) == IS_LONG )
  8. {
  9. php_printf("类型是 IS_LONG,值是:%ld" , Z_LVAL_P(zv_p));
  10. }
  11. if(Z_TYPE_PP(zv_pp) == IS_DOUBLE )
  12. {
  13. php_printf("类型是 IS_DOUBLE,值是:%f" , Z_DVAL_PP(zv_pp) );
  14. }
  15. }

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

  1. void 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:返回handle标识符,OBJ_HT:handle表,OBJCE:类定义,OBJPROP:HashTable的属性,OBJ_HANDLER:在OBJ_HT中操作一个特殊的handler方法。现在不用担心这些宏对象的意思,后续有专门的章节介绍object。

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

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

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