├── README.md
└── 数组相关.md


/README.md:
--------------------------------------------------------------------------------
 1 | # php7_wrapper
 2 | ### 写在前面：
 3 | > swoole的出现让php进入了除了web的其他领域，php7的性能提升又再次拓宽了php的应用范围，例如游戏领域，但php7为了提升性能修改了大量的zendapi，看到新版本的zendapi相信大家得第一反应都是，改动太大了！为啥不兼容之前的，还是那句话都是为了性能提升，所以基本所有的php扩展都需要做一个分支出来支持新版本php，对扩展开发者来说需要同时维护两套代码，使用扩展的人就需要针对每个php版本编译不同的so文件比较麻烦，本文将从另一个角度来尝试解决这个问---通过引入一组兼容层函数来尽量少修改扩展代码并且一套代码支持所有php，并且此方案已经成功的应用在了swoole和php-cp(pdo和redis代理)项目中，下面将分为几个部分讲具体的实现以及php7中为什么改成这样
 4 | 
 5 | #### 内存和字符串相关
 6 | 
 7 | ### 1、MAKE_STD_ZVAL
 8 | > php7的改动很大的就是内存的部分，首先新设计的zval、zend_string、hashtable(ng中也叫zend_array)等数据结构体积很小并且很紧凑，能充分利用cpu的cache，其次大量用栈空间代替在堆中申请内存，反应到扩展层面就是去掉了MAKE_STD_ZVAL和ALLOC_INIT_ZVAL等内存申请的宏定义，因为phpng的zendapi都不需要在堆上申请内存然后把地址传给zendapi（当然如果业务确实需要你也可以手动emalloc内存），swoole和php-cp中是怎么做的呢？  
 9 | 首先，将扩展中所有的MAKE_STD_ZVAL批量替换为SW_MAKE_STD_ZVAL  
10 | 其次，我们再看SW_MAKE_STD_ZVAL的定义：  
11 | 
12 | ```c
13 | #if PHP_MAJOR_VERSION < 7
14 |   #define SW_MAKE_STD_ZVAL(p)            MAKE_STD_ZVAL(p)
15 | #else
16 |   #define SW_MAKE_STD_ZVAL(p)            zval _stack_zval_##p; p = &(_stack_zval_##p)  //宏展开后就是在栈上定义的zval
17 | #endif
18 | ```
19 | > 可以看到在phpng中SW_MAKE_STD_ZVAL就是在栈上定义了一个zval 然后把地址赋值给p，在之前的php版本中就是直接调用MAKE_STD_ZVAL
20 | 注意：此方法能适应大部分用到MAKE_STD_ZVAL的地方，但是有些时候,例如：MAKE_STD_ZVAL得到的栈地址需要在其他函数中用(如果返回的变量是临时的变量可以用inline函数来解决)，是不行的，需要手动emalloc，就如开头说的"通过引入一组兼容层函数来尽量少修改扩展代码"。
21 | 
22 | ### 2、zval_ptr_dtor
23 | > zval_ptr_dtor在之前的php版本中传递参数是指针的指针，phpng中是zval的指针.  
24 | 首先，将扩展中所有的zval_ptr_dtor替换成sw_zval_ptr_dtor（以下都如此不再赘述）。  
25 | 兼容宏代码如下：
26 | ```c
27 | #if PHP_MAJOR_VERSION < 7
28 |   #define sw_zval_ptr_dtor               zval_ptr_dtor
29 | #else
30 |   #define sw_zval_ptr_dtor(p)            zval_ptr_dtor(*p) //用*操作把指针的指针变成指针（好绕口）
31 | #endif
32 | ```
33 | 有人可能会问，在上面说了是通过栈来模拟malloc内存，那这里的释放内存是不是会段错误？
34 | ```c
35 | if (Z_REFCOUNTED_P(zval_ptr)) {
36 | 		if (!Z_DELREF_P(zval_ptr)) {
37 | 			_zval_dtor_func_for_ptr(Z_COUNTED_P(zval_ptr) ZEND_FILE_LINE_RELAY_CC);
38 | 		} else {
39 | 			GC_ZVAL_CHECK_POSSIBLE_ROOT(zval_ptr);
40 | 		}
41 | 	}
42 | ```
43 | 如上，因为phpng中释放内存之前会判断如果不是引用变量类型就跳过不做任何操作。
44 | 
45 | ### 3、zval_add_ref
46 | > 添加引用计数的方法:
47 | ```c
48 | #if PHP_MAJOR_VERSION < 7
49 |  #define sw_zval_add_ref             zval_add_ref
50 | #else
51 |  #define sw_zval_add_ref(p)          Z_TRY_ADDREF_P(*p)//phpng会先判断类型然后再加引用
52 | #endif
53 | ```
54 | 
55 | ### 4、SW_ZVAL_STRING，SW_ZVAL_STRINGL，RETURN_STRINGL，RETVAL_STRINGL，RETURN_STRING
56 | > 在之前的php版本中，这一组函数的最后一个参数是是否需要复制字符串如下：
57 | ```c
58 |  Z_STRVAL_P(__z) = (duplicate?estrndup(__s, Z_STRLEN_P(__z)):(char*)__s);//duplicate就是上述一组函数的最后一个参数
59 | ```
60 | 但是在phpng中始终返回zend_string不需要duplicate参数所以兼容宏如下：
61 | ```c
62 | #if PHP_MAJOR_VERSION < 7
63 | #define SW_ZVAL_STRINGL                       ZVAL_STRINGL
64 | #define SW_ZVAL_STRING                        ZVAL_STRING
65 | #define SW_RETURN_STRINGL                     RETURN_STRINGL
66 | #define SW_RETURN_STRING                      RETURN_STRING
67 | #define SW_RETVAL_STRINGL                     RETVAL_STRINGL
68 | #else
69 | #define SW_ZVAL_STRINGL(z, s, l, dup)         ZVAL_STRINGL(z, s, l)
70 | #define SW_ZVAL_STRING(z,s,dup)               ZVAL_STRING(z,s)
71 | #define SW_RETURN_STRINGL(s, l, dup)          RETURN_STRINGL(s, l)
72 | #define SW_RETURN_STRING(val, dup)            RETURN_STRING(val)
73 | #define SW_RETVAL_STRINGL(s, l, dup)          RETVAL_STRINGL(s, l);
74 | #endif
75 | ```
76 | 可以看到在phpng中就是简单的忽略了dup参数，需要注意的是，如果你原来的代码中最后一个参数是0并且第一个参数是在堆上申请的需要efree(s)第一个参数来释放内存。
77 | 
78 | 


--------------------------------------------------------------------------------
/数组相关.md:
--------------------------------------------------------------------------------
 1 | 
 2 | ### 数组（hashtable）相关：
 3 | > phpng数组操作的api基本全变了，我们一个个过。
 4 | ### 1.创建数组：
 5 | >在之前的版本中是这样：
 6 | ```c
 7 |     zval *val = NULL;
 8 |     MAKE_STD_ZVAL(val);
 9 |     array_init(val);
10 | ```
11 | 是在
12 | ### 2.
13 | add_assoc_zval 用法没变
14 | 
15 | 


--------------------------------------------------------------------------------