接收参数

    写php扩展不仅仅只是要求会c语言,还需要了解php源码。 因为自己写的东西,总会有这样那样的缺点,比如内存泄露,不利维护,开发量大等。php已经准备好了大量的宏,用于扩展开发,我们遵循php提供的宏,最高效的开发扩展。

首先接收参数

1.zend_parse_params();

    第一个参数表示接收参数的个数,一般用宏:ZEND_NUM_ARGS() TSRMLS_CC,中间是空格,后面的是跟线程安全有关的,具体的话还不清楚,书上也没有解释。

    第二个参数是接收参数的类型。

b   Boolean

l   Integer

d   Floating point

s   String

r   Resource

a   Array

o   Object instance

O   Object instance of a specified type           特定类型对象

z   Non-specific zval              任意类型

Z   Dereferenced non-specific zval          zval类型

f         表示函数方法和名称

+         可变参类型(书上没有,自己看var_dump源码,做实验得出,下面有解释)

还有见过别的,想不起来了,以后遇到再补充了,书上只写这么多

后面的参数,就是接收的参数地址了,类似printf。

例子:

PHP_FUNCTION(sample_getlong)

{

  long foo;

  char *name;

  int name_len;

  if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,"ls", &foo.&name,&name_len) == FAILURE) {

        RETURN_NULL();

   }

   php_printf("The integer value of the parameter you passed is: %ld\n", foo);

   PHPWRITE(name, name_len);

   RETURN_TRUE;

}

字符串会特殊一点,先是字符地址,然后是字符串长度

修饰符

    |  接下来是可选参数了. 当指定它时, 所有之前的参数都被认为是必须的, 所有后续的参数都被认为是可选的.

    !  !之前的一个修饰符对应的参数如果是NULL, 提供的内部变量将被设置为真实的NULL指针.

/        /之前的一个修饰符对应的参数指定为写时拷贝, 它将自动的隔离到新的zval(is_ref = 0, refcount = 1)


实现可变参数,就在参数类型字符后面加上修饰符即可,要做好初始化。

char *name;

int name_len;

char *greeting = "Mr./Mrs.";

int greeting_len = sizeof("Mr./Mrs.") - 1;

/* 如果调用时没有传递第二个参数, 则greeting和greeting_len保持不变. */

if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|s",

&name, &name_len, &greeting, &greeting_len) == FAILURE) {

RETURN_NULL();

}

php_printf("Hello ");

PHPWRITE(greeting, greeting_len);

php_printf(" ");

PHPWRITE(name, name_len);

php_printf("!\n");


当一个变量传递给别的函数时候,不论是否被引用传值,refcount至少是2,一个是自己,一个是函数的copy(但不是真正的copy),所以,如果要对变量进行修改,要进行隔离拷贝。所以要使用 / 修饰符.

还有一组别的宏用来接收参数(老版本的,十分不友好,还是不提了)

可以看standard/var.c     看看vardump的实现

PHP_FUNCTION(var_dump)

{

zval ***args;

int argc;

int i;

if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "+", &args, &argc) == FAILURE) {

return;

}

for (i = 0; i < argc; i++) {

php_var_dump(args[i], 1 TSRMLS_CC);

}

efree(args);

}

这个类型符号"+",是可变参数类型,argc是参数个数,var_dump($a,$b,$c),argc是3。然后php_var_dump分别输出每个变量。


zend_API.c有关于接收参数的实现。

va_list是c语言里面接收可变参数宏

参考zend_parse_parameters的实现:

ZEND_API int zend_parse_parameters(int num_args TSRMLS_DC, const char *type_spec, ...) /* {{{ */

{

va_list va;

int retval;

RETURN_IF_ZERO_ARGS(num_args, type_spec, 0);

va_start(va, type_spec); //初始化

retval = zend_parse_va_args(num_args, type_spec, &va, 0 TSRMLS_CC); //这里面是php做的一层封装,里面的核心是va_arg获取可变参数

va_end(va);//清空可变参列表

return retval;

}

INTSIZEOF 宏,获取类型占用的空间长度,最小占用长度为int的整数倍:#define _INTSIZEOF(n) ( (sizeof(n) + sizeof(int) - 1) & ~(sizeof(int) - 1) )

VA_START宏,获取可变参数列表的第一个参数的地址(ap是类型为va_list的指针,v是可变参数最左边的参数):

#define va_start(ap,v) ( ap = (va_list)&v + _INTSIZEOF(v) )

VA_ARG宏,获取可变参数的当前参数,返回指定类型并将指针指向下一参数(t参数描述了当前参数的类型):

#define va_arg(ap,t) ( *(t *)((ap += _INTSIZEOF(t)) - _INTSIZEOF(t)) )

VA_END宏,清空va_list可变参数列表:

#define va_end(ap) ( ap = (va_list)0 )

如果有多个可变参,那么就循环va_arg。



在强调一次,接收参数时候,如果参数要修改,需要写时复制,那么需要"/"修饰符。(原因在zend内存管理有解释)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,560评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,104评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,297评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,869评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,275评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,563评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,833评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,543评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,245评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,512评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,011评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,359评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,006评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,062评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,825评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,590评论 2 273
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,501评论 2 268

推荐阅读更多精彩内容