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