php扩展 zval_copy_ctor,Zend API：pval/zval 数据结构

在PHP里pval 和zval 是同一个数据结构，

typedef union _zvalue_value {

long lval;

double dval;

struct {

char *val;

int len;

} str;

HashTable *ht;

zend_object obj;

} zvalue_value;

//pzval和zval的定义：

struct _zval_struct {

zvalue_value value;

zend_uchar type;

zend_uchar is_ref;

zend_ushort refcount;

};

下面介绍下zval相关的宏

MAKE_STD_ZVAL()

这个可能是使用的最多的宏了，因为它的工作就是初始化一个zval,代码实例：

zval *var;

MAKE_STD_ZVAL(var);

通过下面这源码，应该很清楚MAKE_STD_ZVAL都干了些什么了吧。分配内存，置refcount为1，置is_ref为0。

// MAKE_STD_ZVAL定义在zend.h里

#define MAKE_STD_ZVAL(zv) \

ALLOC_ZVAL(zv); \

INIT_PZVAL(zv);

//ALLOC_ZVAL定义在zend_alloc.h

#define ALLOC_ZVAL(z)\

ZEND_FAST_ALLOC(z, zval, ZVAL_CACHE_LIST)

//ZEND_FAST_ALLOC定义在zend_alloc.h

#define ZEND_FAST_ALLOC(p, type, fc_type)\

(p) = (type *) emalloc(sizeof(type))

// INIT_PZVAL定义在 zend.h

#define INIT_PZVAL(z)\

(z)->refcount__gc = 1;\

(z)->is_ref__gc = 0;

SEPARATE_ZVAL()

这个宏是用于变量分离操作的。为什么要进行变量分离呢？主要原因还是在PHP语言里如果变量不是以引用的方式传递，那么在扩展里修改参数的值时是不能影响到原来的值的。但是PHP又是一个写时拷贝的。所以能在对一个由用户传递过来的参数进行修改时，必须进行变量分离，否则就会造成用户传递的参数被修改。

// SEPARATE_ZVAL定义在zend.h

#define SEPARATE_ZVAL(ppzv)\

{\

zval *orig_ptr = *(ppzv);\

\

if (Z_REFCOUNT_P(orig_ptr) > 1) {\

Z_DELREF_P(orig_ptr);\

ALLOC_ZVAL(*(ppzv));\

**(ppzv) = *orig_ptr;\

zval_copy_ctor(*(ppzv));\

Z_SET_REFCOUNT_PP(ppzv, 1);\

Z_UNSET_ISREF_PP((ppzv));\

}\

}

zval_copy_ctor()

zval 的拷贝构造函数(其实也是一个宏函数)，通过这个宏，我们深拷贝一个zval。实例代码：

zval **old, *new;

*new = **old;

zval_copy_ctor(new); // zval_copy_ctor定义在zend_variables.h

#define zval_copy_ctor(zvalue) _zval_copy_ctor((zvalue) ZEND_FILE_LINE_CC)

ZEND_API void _zval_copy_ctor_func(zval *zvalue ZEND_FILE_LINE_DC);

static inline void _zval_copy_ctor(zval *zvalue ZEND_FILE_LINE_DC)

{

if (zvalue->type <= IS_BOOL) {

return;

}

_zval_copy_ctor_func(zvalue ZEND_FILE_LINE_RELAY_CC);

}

变量值的访问：(定义在zend_operators.h)

Long

Boolean

Double

String value

String length

Z_LVAL()

Z_BVAL()

Z_DVAL()

Z_STRVAL()

Z_STRLEN()

Z_LVAL_P()

Z_BVAL_P()

Z_DVAL_P()

Z_STRVAL_P()

Z_STRLEN_P()

Z_LVAL_PP()

Z_BVAL_PP()

Z_DVAL_PP()

Z_STRVAL_PP()

Z_STRLEN_PP()

HashTable

Object

Object properties

Object class entry

Resource value

Z_ARRVAL()

Z_OBJ()

Z_OBJPROP()

Z_OBJCE()

Z_RESVAL()

Z_ARRVAL_P()

Z_OBJ_P()

Z_OBJPROP_P()

Z_OBJCE_P()

Z_RESVAL_P()

Z_ARRVAL_PP()

Z_OBJ_PP()

Z_OBJPROP_PP()

Z_OBJCE_PP()

Z_RESVAL_PP()

获取量的类型：

// 定义在zend_operators.h 有关zvl的大部分操作宏都在这里文件里

#define Z_TYPE(zval)(zval).type

#define Z_TYPE_P(zval_p)Z_TYPE(*zval_p)

#define Z_TYPE_PP(zval_pp)Z_TYPE(**zval_pp) PHP里预定义的变量类型有一下几种：

// 以下变量类型定义在zend.h里

/* data types */

/* All data types <= IS_BOOL have their constructor/destructors skipped */

#define IS_NULL0

#define IS_LONG1

#define IS_DOUBLE2

#define IS_BOOL3

#define IS_ARRAY4

#define IS_OBJECT5

#define IS_STRING6

#define IS_RESOURCE7

#define IS_CONSTANT8

#define IS_CONSTANT_ARRAY9