接收参数

    写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内存管理有解释)

你可能感兴趣的:(接收参数)