PHP7扩展开发之传参与返回值前言

这次，我们将演示如何在php扩展中接受传入的参数和输出返回值。

我们将在扩展中实现<code>default_value</code>方法。

str_concat方法的php扩展源码：

在php7中提供了两种获取参数的方法。<code>zend_parse_parameters</code>和fast zpp方式。

在php7之前一直使用<code>zend_parse_parameters</code>函数获取参数。这个函数的作用，就是把传入的参数转换为php内核中相应的类型，方便在php扩展中使用。

参数说明：

第一个参数，参数个数。一般就使用<code>zend_num_args()</code>，不需要改变。

第二个参数，格式化字符串。这个格式化字符串的作用就是，指定传入参数与php内核类型的转换关系。

代码中 s|z 的含义就是：

除此之外，还有一些specifier，需要注意：

在php7中新提供的方式。是为了提高参数解析的性能。对应经常使用的方法，建议使用fast zpp方式。

使用方式：

以<code>zend_parse_parameters_start(1, 2)</code>开头。

第一个参数表示必传的参数格式，第二个参数表示最多传入的参数个数。

以<code>zend_parse_parameters_end();</code>结束。

中间是传入参数的解析。

值得注意的是，一般fast zpp的宏方法与zend_parse_parameters的specifier是一一对应的。如：

z_param_optional 对应 |

z_param_str 对应 s

但是，z_param_zval_ex方法比较特殊。它对应两个specifier，分别是 ! 和 / 。! 对应宏方法的第二个参数。/ 对应宏方法的第三个参数。如果想开启，只要设置为1即可。

方法的返回值是使用<code>return_</code>开头的宏方法进行返回的。常用的宏方法有：

return_null() 返回null

return_long(l) 返回整型

return_double(d) 返回浮点型

return_str(s) 返回一个字符串。参数是一个zend_string * 指针

return_string(s) 返回一个字符串。参数是一个char * 指针

return_stringl(s, l) 返回一个字符串。第二个参数是字符串长度。

return_empty_string() 返回一个空字符串。

return_arr(r) 返回一个数组。参数是zend_array *指针。

return_obj(r) 返回一个对象。参数是zend_object *指针。

return_zval(zv, copy, dtor) 返回任意类型。参数是 zval *指针。

return_false 返回false

return_true 返回true

更多宏方法请查看 zend/zend_api.h中的相关代码。

<a href="http://www.bo56.com/php7%e6%ba%90%e7%a0%81%e9%98%85%e8%af%bb%e7%ac%94%e8%ae%b0%ef%bc%88%e4%b8%8d%e6%96%ad%e6%9b%b4%e6%96%b0%ef%bc%89/">更多函数说明请查看</a>

<a href="http://www.bo56.com/download/php7_ext/say_default_value.tar.gz">tar.gz格式下载</a>

<a href="http://www.bo56.com/download/php7_ext/say_default_value.zip">zip格式下载</a>