欢迎来到[自学php网] ①群 AG亚游集团

AG亚游集团 > php专栏 > AG亚游集团php综合实列 >

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

来源:未知 ?? 时间:2018-06-15 09:39?作者:小飞侠

[导读] 前言,这次,我们将演示如何在PHP扩展中接受传入的参数和输出返回值。 ?phpfunctiondefault_value($type,$value=null){if($type==int){return$value??0;}elseif($type==bool){return$value??false;}elseif($type==str){returnis_n...

前言,这次,我们将演示如何在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.


更多格式化字符串的含义可以查看官方网站。/wikiaff4phpaff4net/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_OPTIONAL 对应 |


Z_PARAM_STR 对应 S


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


FAST ZPP相应的宏方法可以查看官方网站 /wikiaff4phpaff4net/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网专注网站建设学习,PHP程序学习,平面设计学习,以及操作系统学习

京ICP备14009008号@版权所有AG亚游集团

网站声明:本站所有视频,教程都由网友上传,站长收集和分享给大家学习使用,如由牵扯版权问题请联系站长邮箱904561283@qq.com

3月流感卷土重来?中疾控专家:不会高于去年冬季 男子无证驾摩托载人 为逃检查将民警撞骨折 罗马大佬:托蒂不适合当教练 他更应该去做… 网贷迎最严审核 行业人士聚散新形态 山东:中小学考试成绩不得公开 单独反馈给学生 有的比赛创造了世界纪录 有的比赛竟成了笑话 IMF总裁:美关税行动或引发“以牙还牙”式贸易报复 王小川委员:科研资金向有科研和转化实力企业倾斜 国资委主任肖亚庆:去年央企募集3577亿资金 特朗普指责欧盟对美产品“不友好” 要求先降关税 男子假扮飞行员用宝马开顺风车 偶遇空姐骗88万 杜特尔特一声令下,兰博基尼成了铁饼...
耀才证券植耀辉: 非农数据成焦点 港股成交缩续观望 想起被支配的恐惧!昔日巨头称勇士最像14冠军 威廉姆斯拟任纽约联储主席:曾是耶伦重要顾问 爱神引导人民!有Love坐镇的骑士怎么可能输? 进球gif-金敬道传中造威胁 李昂不慎自摆乌龙 劳森是否回归周二将有定论?俱乐部态度暧昧 时速超一千公里跑得比飞机快 这样的火车你期待吗 鲁能客战华夏将演一场雪战 客胜需克服重重困难 日拉面馆社长涉嫌让中国留学生超时工作 被送检 美军费多高?相当于位居其后7个军费支出大国之和 京沪川军通关江苏失好局 山东男排下马大跌眼镜 文在寅就慰安妇问题批日本 日高官:违反日韩共识
八一勋章获得者在论坛留言被围攻 还遭管理员删帖 报告:特斯拉工厂需要比其它汽车厂商更多人类员工 杨庆山任南开大学书记 魏大鹏不再担任(图/简历) 美军自查对外国产品依赖程度 中国制造非常突出(图) 关闭时装公司 “第一千金”伊万卡专心从政 又见08届对决!威少强势却难抵想看这12+3的心 肇事司机和车主昼夜陪护被撞老人 感动老人亲属 美军首架KC-46加油机将于年内交付 可载96吨燃油 瑞达期货:棕榈小幅上涨 延续反弹走势 地摊卖什么最火 90后怎么赚钱白手起家 拿回家做的手工活大批 没学历女生做什么工作 AG亚游集团