add var

Author: pangudashu

7/var.md

@@ -3,7 +3,7 @@
 
 本节提到的zval泛指zval及各种zend_value。
 
-### 7.7.1 生成不同类型的zval
+### 7.7.1 新生成各类型zval
 PHP7将变量的引用计数转移到了具体的value上，所以zval更多的是作为统一的传输格式，很多情况下只是临时性使用，比如函数调用时的传参，最终需要的数据是zval携带的zend_value，函数从zval取得zend_value后就不再关心zval了，这种就可以直接在栈上分配zval。分配完zval后需要将其设置为我们需要的类型以及设置其zend_value，PHP中定义的`ZVAL_XXX()`系列宏就是用来干这个的，这些宏第一个参数z均为要设置的zval的指针，后面为要设置的zend_value。
 
 * __ZVAL_UNDEF(z):__ 表示zval被销毁
@@ -27,7 +27,85 @@ PHP7将变量的引用计数转移到了具体的value上，所以zval更多的
 * __ZVAL_NEW_REF(z, r):__ 新创建一个引用，r为引用的值，类型为zval*
 * ...
 
-### 7.7.2 获取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变量类型相关的宏之外，还有一些内核自己使用类型的宏：
+```c
+//获取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))
+```
+zend_string常用的宏：
+```c
+//zstr类型为zend_string*
+#define ZSTR_VAL(zstr)  (zstr)->val
+#define ZSTR_LEN(zstr)  (zstr)->len
+#define ZSTR_H(zstr)    (zstr)->h
+#define ZSTR_HASH(zstr) zend_string_hash_val(zstr)
+```
 ### 7.7.3 引用计数
+```c
+//获取引用数：pz类型为zval*
+#define Z_REFCOUNT_P(pz)            zval_refcount_p(pz)
+//设置引用数
+#define Z_SET_REFCOUNT_P(pz, rc)    zval_set_refcount_p(pz, rc)
+//增加引用
+#define Z_ADDREF_P(pz)              zval_addref_p(pz)
+//减少引用
+#define Z_DELREF_P(pz)              zval_delref_p(pz)
+
+#define Z_REFCOUNT(z)               Z_REFCOUNT_P(&(z))
+#define Z_SET_REFCOUNT(z, rc)       Z_SET_REFCOUNT_P(&(z), rc)
+#define Z_ADDREF(z)                 Z_ADDREF_P(&(z))
+#define Z_DELREF(z)                 Z_DELREF_P(&(z))
+
+//只对使用了引用计数的变量类型增加引用，建议使用这个
+#define Z_TRY_ADDREF_P(pz) do {     \
+    if (Z_REFCOUNTED_P((pz))) {     \
+        Z_ADDREF_P((pz));           \
+    }                               \
+} while (0)
+
+#define Z_TRY_DELREF_P(pz) do {     \
+    if (Z_REFCOUNTED_P((pz))) {     \
+        Z_DELREF_P((pz));           \
+    }                               \
+} while (0)
+
+#define Z_TRY_ADDREF(z)             Z_TRY_ADDREF_P(&(z))
+#define Z_TRY_DELREF(z)             Z_TRY_DELREF_P(&(z))
+```
+
+### 7.7.4 数组操作
 

README.md

@@ -66,7 +66,12 @@
       * <a href="7/func.md#763-引用传参">7.6.3 引用传参</a>
       * <a href="7/func.md#764-函数返回值">7.6.4 函数返回值</a>
       * <a href="7/func.md#765-函数调用">7.6.5 函数调用</a>
-   * 7.7 变量的操作
+   * [7.7 zval的操作](7/var.md)
+      * [7.7.1 新生成各类型zval](7/var.md)
+      * [7.7.2 获取zval的值及类型](7/var.md)
+      * [7.7.3 引用计数](7/var.md)
+      * [7.7.4 数组操作](7/var.md)
+   * 7.8 常量
    * 7.9 面向对象
       * 7.6.1 扩展中创建对象
       * 7.6.2 创建内部类