PHP扩展开发中的常用宏总结与解析（持续更新）

#define ZEND_STRL(str) (str), (sizeof(str)-1)

#define TSRMLS_D void ***tsrm_ls

#define TSRMLS_DC , void ***tsrm_ls // 定义

#define TSRMLS_C tsrm_ls

#define TSRMLS_CC , tsrm_ls // 调用

// 定义常量

zend_declare_class_constant_*

// 增加数组索引和值

add_assoc_*

add_index_*

// 定义并初始化数组

zval *levels;

MAKE_STD_ZVAL(levels); // ALLOC_INIT_ZVAL 它会将所指的zval的类型设置为IS_NULL;

array_init(levels);

// 定义方法

PHP_METHOD // ZEND_METHOD

PHP_ME // ZEND_ME

// 初始化类

INIT_CLASS_ENTRY(ce, name, methods)

zend_register_internal_class // 注册类

zend_register_internal_class_ex

zend_class_entry

zend_function_entry

// 操作zval

ZVAL_NULL

ZVAL_BOOL

ZVAL_LONG

ZVAL_STRINGL

ZVAL_*

// 类型转换

convert_to_long

convert_to_*

// 设置符号表

ZEND_SET_SYMBOL

// 释放变量内存

FREE_ZVAL

FREE_ZVAL_REL

FREE_ZVAL_EX

FREE_ZVAL_REL_EX

// 申请内存

ALLOC_ZVAL_REL

ALLOC_ZVAL

ALLOC_PERMANENT_ZVAL

// 操作整数的

#define Z_LVAL(zval) (zval).value.lval

#define Z_LVAL_P(zval_p) Z_LVAL(*zval_p)

#define Z_LVAL_PP(zval_pp) Z_LVAL(**zval_pp)

// 操作IS_BOOL布尔型的

#define Z_BVAL(zval) ((zend_bool)(zval).value.lval)

#define Z_BVAL_P(zval_p) Z_BVAL(*zval_p)

#define Z_BVAL_PP(zval_pp) Z_BVAL(**zval_pp)

// 操作浮点数的

#define Z_DVAL(zval) (zval).value.dval

#define Z_DVAL_P(zval_p) Z_DVAL(*zval_p)

#define Z_DVAL_PP(zval_pp) Z_DVAL(**zval_pp)

// 操作字符串的值和长度的

#define Z_STRVAL(zval) (zval).value.str.val

#define Z_STRVAL_P(zval_p) Z_STRVAL(*zval_p)

#define Z_STRVAL_PP(zval_pp) Z_STRVAL(**zval_pp)

#define Z_STRLEN(zval) (zval).value.str.len

#define Z_STRLEN_P(zval_p) Z_STRLEN(*zval_p)

#define Z_STRLEN_PP(zval_pp) Z_STRLEN(**zval_pp)

#define Z_ARRVAL(zval) (zval).value.ht

#define Z_ARRVAL_P(zval_p) Z_ARRVAL(*zval_p)

#define Z_ARRVAL_PP(zval_pp) Z_ARRVAL(**zval_pp)

// 操作对象的

#define Z_OBJVAL(zval) (zval).value.obj

#define Z_OBJVAL_P(zval_p) Z_OBJVAL(*zval_p)

#define Z_OBJVAL_PP(zval_pp) Z_OBJVAL(**zval_pp)

#define Z_OBJ_HANDLE(zval) Z_OBJVAL(zval).handle

#define Z_OBJ_HANDLE_P(zval_p) Z_OBJ_HANDLE(*zval_p)

#define Z_OBJ_HANDLE_PP(zval_p) Z_OBJ_HANDLE(**zval_p)

#define Z_OBJ_HT(zval) Z_OBJVAL(zval).handlers

#define Z_OBJ_HT_P(zval_p) Z_OBJ_HT(*zval_p)

#define Z_OBJ_HT_PP(zval_p) Z_OBJ_HT(**zval_p)

#define Z_OBJCE(zval) zend_get_class_entry(&(zval) TSRMLS_CC)

#define Z_OBJCE_P(zval_p) Z_OBJCE(*zval_p)

#define Z_OBJCE_PP(zval_pp) Z_OBJCE(**zval_pp)

#define Z_OBJPROP(zval) Z_OBJ_HT((zval))->get_properties(&(zval) TSRMLS_CC)

#define Z_OBJPROP_P(zval_p) Z_OBJPROP(*zval_p)

#define Z_OBJPROP_PP(zval_pp) Z_OBJPROP(**zval_pp)

#define Z_OBJ_HANDLER(zval, hf) Z_OBJ_HT((zval))->hf

#define Z_OBJ_HANDLER_P(zval_p, h) Z_OBJ_HANDLER(*zval_p, h)

#define Z_OBJ_HANDLER_PP(zval_p, h) Z_OBJ_HANDLER(**zval_p, h)

#define Z_OBJDEBUG(zval,is_tmp) (Z_OBJ_HANDLER((zval),get_debug_info)? \

Z_OBJ_HANDLER((zval),get_debug_info)(&(zval),&is_tmp TSRMLS_CC): \

(is_tmp&＃61;0,Z_OBJ_HANDLER((zval),get_properties)?Z_OBJPROP(zval):NULL))

#define Z_OBJDEBUG_P(zval_p,is_tmp) Z_OBJDEBUG(*zval_p,is_tmp)

#define Z_OBJDEBUG_PP(zval_pp,is_tmp) Z_OBJDEBUG(**zval_pp,is_tmp)

// 操作资源的

#define Z_RESVAL(zval) (zval).value.lval

#define Z_RESVAL_P(zval_p) Z_RESVAL(*zval_p)

#define Z_RESVAL_PP(zval_pp) Z_RESVAL(**zval_pp)

#define RETURN_RESOURCE(l) { RETVAL_RESOURCE(l); return; }

#define RETURN_BOOL(b) { RETVAL_BOOL(b); return; }

#define RETURN_NULL() { RETVAL_NULL(); return;}

#define RETURN_LONG(l) { RETVAL_LONG(l); return; }

#define RETURN_DOUBLE(d) { RETVAL_DOUBLE(d); return; }

#define RETURN_STRING(s, duplicate) { RETVAL_STRING(s, duplicate); return; }

#define RETURN_STRINGL(s, l, duplicate) { RETVAL_STRINGL(s, l, duplicate); return; }

#define RETURN_EMPTY_STRING() { RETVAL_EMPTY_STRING(); return; }

#define RETURN_ZVAL(zv, copy, dtor) { RETVAL_ZVAL(zv, copy, dtor); return; }

#define RETURN_FALSE { RETVAL_FALSE; return; }

#define RETURN_TRUE