Zend API：pval/zval 数据结构

最新推荐文章于 2024-11-03 11:01:20 发布

weixin_33963189

最新推荐文章于 2024-11-03 11:01:20 发布

阅读量141

点赞数

文章标签：数据结构与算法 php

原文链接：https://my.oschina.net/jackin/blog/173885

版权

为什么80%的码农都做不了架构师？>>>

在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_NULL		0
#define IS_LONG		1
#define IS_DOUBLE	2
#define IS_BOOL		3
#define IS_ARRAY	4
#define IS_OBJECT	5
#define IS_STRING	6
#define IS_RESOURCE	7
#define IS_CONSTANT	8
#define IS_CONSTANT_ARRAY	9

转载于:https://my.oschina.net/jackin/blog/173885