获取zval的值及类型

7.7.2 获取zval的值及类型

zval的类型通过Z_TYPE(zval)、Z_TYPE_P(zval*)两个宏获取，这个值取的就是zval.u1.v.type，但是设置时不要只修改这个type，而是要设置typeinfo，因为zval还有其它的标识需要设置，比如是否使用引用计数、是否可被垃圾回收、是否可被复制等等。

内核提供了Z_XXX(zval)、Z_XXX_P(zval*)系列的宏用于获取不同类型zval的value。

• Z_LVAL(zval)、Z_LVAL_P(zval_p): 返回zend_long
• Z_DVAL(zval)、Z_DVAL_P(zval_p): 返回double
• Z_STR(zval)、Z_STR_P(zval_p): 返回zend_string*
• Z_STRVAL(zval)、Z_STRVAL_P(zval_p): 返回char*，即：zend_string->val
• Z_STRLEN(zval)、Z_STRLEN_P(zval_p): 获取字符串长度
• Z_STRHASH(zval)、Z_STRHASH_P(zval_p): 获取字符串的哈希值
• Z_ARR(zval)、Z_ARR_P(zval_p)、Z_ARRVAL(zval)、Z_ARRVAL_P(zval_p): 返回zend_array*
• Z_OBJ(zval)、Z_OBJ_P(zval_p): 返回zend_object*
• Z_OBJ_HT(zval)、Z_OBJ_HT_P(zval_p): 返回对象的zend_object_handlers，即zend_object->handlers
• Z_OBJ_HANDLER(zval, hf)、Z_OBJ_HANDLER_P(zv_p, hf): 获取对象各操作的handler指针，hf为write_property、read_property等，注意：这个宏取到的为只读，不要试图修改这个值(如：Z_OBJ_HANDLER(obj, write_property) = xxx;)，因为对象的handlers成员前加了const修饰符
• Z_OBJCE(zval)、Z_OBJCE_P(zval_p): 返回对象的zend_class_entry*
• Z_OBJPROP(zval)、Z_OBJPROP_P(zval_p): 获取对象的成员数组
• Z_RES(zval)、Z_RES_P(zval_p): 返回zend_resource*
• Z_RES_HANDLE(zval)、Z_RES_HANDLE_P(zval_p): 返回资源handle
• Z_RES_TYPE(zval)、Z_RES_TYPE_P(zval_p): 返回资源type
• Z_RES_VAL(zval)、Z_RES_VAL_P(zval_p): 返回资源ptr
• Z_REF(zval)、Z_REF_P(zval_p): 返回zend_reference*
• Z_REFVAL(zval)、Z_REFVAL_P(zval_p): 返回引用的zval*

除了这些与PHP变量类型相关的宏之外，还有一些内核自己使用类型的宏：

//获取indirect的zval，指向另一个zval
#define Z_INDIRECT(zval)            (zval).value.zv
#define Z_INDIRECT_P(zval_p)        Z_INDIRECT(*(zval_p))

#define Z_CE(zval)                  (zval).value.ce
#define Z_CE_P(zval_p)              Z_CE(*(zval_p))

#define Z_FUNC(zval)                (zval).value.func
#define Z_FUNC_P(zval_p)            Z_FUNC(*(zval_p))

#define Z_PTR(zval)                 (zval).value.ptr
#define Z_PTR_P(zval_p)             Z_PTR(*(zval_p))