一步一步开发PHP扩展(2):参数传递与返回值处理

在上一篇笔记中,我们已经为PHP7增加了一个say()函数,但是细心的你肯定也发现了say()函数执行时只输出了一个字符串“hello world”,我们既无法传递参数进去,也无法更改该函数的返回信息。因此本篇笔记咱们就说说开发PHP扩展时参数传递与返回值处理。

php7扩展开发教程

在PHP开发中我们经常碰到参数类型的判断,如下代码片段所示:

  1. <?php
  2.     function default_value ($type$value = null) {
  3.         if ($type == "int") {
  4.             return $value ?? 0;
  5.         } else if ($type == "bool") {
  6.             return $value ?? false;
  7.         } else if ($type == "str") {
  8.             return is_null($value) ? "" : $value;
  9.         }
  10.         return null;
  11.     }
  12.     var_dump(default_value("int"));
  13.     var_dump(default_value("int", 1));
  14.     var_dump(default_value("bool"));
  15.     var_dump(default_value("bool", true));
  16.     var_dump(default_value("str"));
  17.     var_dump(default_value("str""a"));
  18.     var_dump(default_value("array"));
  19. ?>

今天我们就在PHP扩展中实现上述的default_value(); 如何创建PHP扩展请参阅>>

以下为实现代码:

  1. PHP_FUNCTION(default_value)
  2. {
  3.     zend_string     *type;
  4.     zval            *value = NULL;
  5. #ifndef FAST_ZPP
  6.     /* Get function parameters and do error-checking. */
  7.     if (zend_parse_parameters(ZEND_NUM_ARGS(), "S|z", &type, &value) == FAILURE) {
  8.         return;
  9.     }
  10. #else
  11.     ZEND_PARSE_PARAMETERS_START(1, 2)
  12.         Z_PARAM_STR(type)
  13.         Z_PARAM_OPTIONAL
  14.         Z_PARAM_ZVAL_EX(value, 0, 1)
  15.     ZEND_PARSE_PARAMETERS_END();
  16. #endif
  17.     if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "int", 3) == 0 && value == NULL) {
  18.         RETURN_LONG(0);
  19.     } else if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "int", 3) == 0 && value != NULL) {
  20.         RETURN_ZVAL(value, 0, 1);
  21.     } else if (ZSTR_LEN(type) == 4 && strncmp(ZSTR_VAL(type), "bool", 4) == 0 && value == NULL) {
  22.         RETURN_FALSE;
  23.     } else if (ZSTR_LEN(type) == 4 && strncmp(ZSTR_VAL(type), "bool", 4) == 0 && value != NULL) {
  24.         RETURN_ZVAL(value, 0, 1);
  25.     } else if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "str", 3) == 0 && value == NULL) {
  26.         RETURN_EMPTY_STRING();
  27.     } else if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "str", 3) == 0 && value != NULL) {
  28.         RETURN_ZVAL(value, 0, 1);
  29.     }
  30.     RETURN_NULL();
  31. }

获取参数

在PHP7中提供了两种获取参数的方法。zend_parse_parametersFAST ZPP方式。

zend_parse_parameters

在PHP7之前一直使用zend_parse_parameters函数获取参数。这个函数的作用,就是把传入的参数转换为PHP内核中相应的类型,方便在PHP扩展中使用。

参数说明:

第一个参数,参数个数。一般就使用ZEND_NUM_ARGS(),不需要改变。

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

代码中 S|z 的含义就是:

S表示参数是一个字符串。要把传入的参数转换为zend_string类型。
| 表示之后的参数是可选。可以传,也可以不传。
z 表示参数是多种类型。要把传入的参数转换为zval类型。

除此之外,还有一些specifier,需要注意:

!如果接收了一个PHP语言里的null变量,则直接把其转成C语言里的NULL,而不是封装成IS_NULL类型的zval。

/ 如果传递过来的变量与别的变量共用一个zval,而且不是引用,则进行强制分离,新的zval的is_ref__gc==0, and refcount__gc==1.

更多格式化字符串的含义可以查看官方网站。https://wiki.php.net/rfc/fast_zpp

FAST ZPP

在PHP7中新提供的方式。是为了提高参数解析的性能。对应经常使用的方法,建议使用FAST ZPP方式。
使用方式:

ZEND_PARSE_PARAMETERS_START(1, 2)开头。

第一个参数表示必传的参数个数,第二个参数表示最多传入的参数个数。

ZEND_PARSE_PARAMETERS_END();结束。

中间是传入参数的解析。

值得注意的是,一般FAST ZPP的宏方法与zend_parse_parameters的specifier是一一对应的。如:

Z_PARAM_OPTIONAL 对应|

Z_PARAM_STR 对应 S

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

FAST ZPP相应的宏方法可以查看官方网站 https://wiki.php.net/rfc/fast_zpp#proposal

返回值

方法的返回值是使用RETURN_开头的宏方法进行返回的。常用的宏方法有:

  • 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中的相关代码。

下篇笔记波波将分享开发PHP扩展时关于变量类型的处理,敬请期待。

你想把广告放到这里吗?

发表评论

您必须 登录 才能发表留言!