文档章节

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

 时间财富网
发布于 2016/11/16 09:40
字数 1172
阅读 15
收藏 0

PHP7扩展开发之传参与返回值
下在我们来看一篇关于PHP7扩展开发之传参与返回值的例子,希望这一篇文章能够帮助到各位朋友,具体的细节如下文介绍.
前言
这次,我们将演示如何在PHP扩展中接受传入的参数和输出返回值。
<?php
    function default_value ($type, $value = null) {
        if ($type == "int") {
            return $value ?? 0;
        } else if ($type == "bool") {
            return $value ?? false;
        } else if ($type == "str") {
            return is_null($value) ? "" : $value;
        }
        return null;
    }
    var_dump(default_value("int"));
    var_dump(default_value("int", 1));
    var_dump(default_value("bool"));
    var_dump(default_value("bool", true));
    var_dump(default_value("str"));
    var_dump(default_value("str", "a"));
    var_dump(default_value("array"));
?>
我们将在扩展中实现`default_value`方法。
代码
基础代码
这个扩展,我们将在say扩展上增加 `default_value` 方法。say扩展相关代码大家请看这篇博文。 PHP7扩展开发之hello word 文中已经详细介绍了如何创建一个扩展和提供了源码下载。
实现default_value方法
str_concat方法的PHP扩展源码:
PHP_FUNCTION(default_value)
{
    zend_string     *type;    
    zval            *value = NULL;
ifndef FAST_ZPP
/* Get function parameters and do error-checking. */ if (zend_parse_parameters(ZEND_NUM_ARGS(), "S|z", &type, &value) == FAILURE) { return; }
else
ZEND_PARSE_PARAMETERS_START(1, 2) Z_PARAM_STR(type) Z_PARAM_OPTIONAL Z_PARAM_ZVAL_EX(value, 0, 1) ZEND_PARSE_PARAMETERS_END();
endif
if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "int", 3) == 0 && value == NULL) { RETURN_LONG(0); } else if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "int", 3) == 0 && value != NULL) { RETURN_ZVAL(value, 0, 1); } else if (ZSTR_LEN(type) == 4 && strncmp(ZSTR_VAL(type), "bool", 4) == 0 && value == NULL) { RETURN_FALSE; } else if (ZSTR_LEN(type) == 4 && strncmp(ZSTR_VAL(type), "bool", 4) == 0 && value != NULL) { RETURN_ZVAL(value, 0, 1); } else if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "str", 3) == 0 && value == NULL) { RETURN_EMPTY_STRING(); } else if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "str", 3) == 0 && value != NULL) { RETURN_ZVAL(value, 0, 1); } RETURN_NULL(); }
代码解读
获取参数
在PHP7中提供了两种获取参数的方法。`zend_parse_parameters`和FAST 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中的相关代码。需要更多资讯请到时间财富网来查阅。

© 著作权归作者所有

粉丝 2
博文 37
码字总数 57314
作品 0
成都
私信 提问
加载中

评论(1)

时间财富网
好东西
CmlPHP V2.5.10 发布,PHP 开源框架

CmlPHP V2.5.10发布,变更: 优化锁机制。同个用户在锁一把锁成功之后。未解锁前重复去加这个锁由返回加锁失败改成返回加锁成功。---实际业务不可能出现这种情况,防止某些场景下的意外... loc...

雨空
2016/01/23
722
8
深入理解PHP7内核之Reference

08 Apr 18 深入理解PHP7内核之Reference 作者: Laruence( ) 本文地址: http://www.laruence.com/2018/04/08/3179.html 转载请注明出处 问题 上一章说过引用(REFERENCE)在PHP5的时候是一个标志...

Laruence
2018/06/26
0
0
2018.06.10 周日--《PHP7--PHP的一次重大变革》

一、写在开头 PHP7是PHP编程语言全新的一个版本,主要在性能方面获得了极大的提升。官方的文档显示,PHP7可以达到PHP5.x版本两倍的性能。同时还对PHP的语法做了梳理,提供了很多其他语言流行...

微信公众号_程序员的文娱情怀
2018/06/10
0
0
CmlPHP V2.8.3 发布,快速稳定易维护的 PHP 框架

CmlPHP V2.8.3 发布了。 上次投递新闻已经是v2.8.0版本,这边列下自v2.8.0以来的主要变更: 最重要的先说!!!可以无缝升级。 setMulti添加是否开启事务选项 添加Ip2Region类。移除ipLocat...

雨空
2018/07/26
558
4
基于PHP7的PHP扩展开发之十三(进行流的操作)

基于PHP7的PHP扩展开发之十三(进行流的操作) Love冥天个人博客-关注IT|PHP|互联网|php个人博客交流2017-07-2940 阅读 目的:在扩展中进行流的操作。简单来讲就是对一些文件,网络的IO操作。...

Love冥天个人博客-关注IT|PHP|互联网|php个人博客交流
2017/07/29
0
0

没有更多内容

加载失败,请刷新页面

加载更多

一个简单易用的Linux文本编辑器:nano的安装与使用

许多状况下咱们都必要编纂云主机里的文本情节,而现时用的比力多的文本编纂器是vim,这个估量许多人都以为很难用,这边伏笔VPS引荐一个简略易用的文本编纂器nano,比vim简略许多,很轻易上手...

shzwork
32分钟前
3
0
go recover

异常、错误常见语言处理 一般语言都有其错误处理方式,就以鄙人熟悉的php来距离吧。 PHP有多个级别的错误处理方式,以防止程序在还未正确执行完毕时,就造成了程序的提前结束。 try/catch/fi...

o0无忧亦无怖
51分钟前
1
0
玩转混合云+边缘计算,且看ZStack Mini!

文章导读:2019年4月16日,ZStack新品和合作伙伴战略发布会上,面向集团客户和边缘场景需求,ZStack重磅推出ZStack Mini超融合一体机(以下简称:ZStack Mini)和ZStack多云管理平台(以下简...

ZStack社区版
52分钟前
2
0
springboot 整合redis

springboot整合redis官方是有文档的: 英文看不懂可以翻译,代码应该看得懂, 这个是自动注入的。当然也可以xml注入,手动配置。 整合步骤: pom文件: <!-- spring boot web --> ...

jason_kiss
56分钟前
2
0
手机耗电问题,大部分是没有正确使用这个“锁”

当安卓设备闲置时,设备很快会进入休眠状态,以达到省电和减少CPU占用的目的。但有些应用在手机灭屏甚至系统休眠时,依然频繁占用CPU处理事件或唤醒屏幕提示用户消息,这类行为会导致手机耗电...

安卓绿色联盟
57分钟前
4
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部