PHP Windows 扩展的开发（2） 参数

在开发PHP扩展的时候，　当我们传递参数给函数的时候，　参数也是要声明的，　并通过zend_FE宏将函数与参数关联起来， 注册到函数表中。

 

对于之前的php_hello_world.dll的例子。

我们对于 函数say_hello函数有传递一个name的参数。

 

对于 这个name的定义如下：

ZEND_BEGIN_ARG_INFO(arg_say_hello, 0) ZEND_ARG_INFO(0, name) ZEND_END_ARG_INFO()

 

实际上这是一个宏定义， 我们来看一个宏的具体 内容

#define ZEND_ARG_INFO(pass_by_ref, name) { #name, sizeof(#name)-1, NULL, 0, 0, 0, pass_by_ref, 0, 0 }, # #define ZEND_ARG_PASS_INFO(pass_by_ref) { NULL, 0, NULL, 0, 0, 0, pass_by_ref, 0, 0 }, #define ZEND_ARG_OBJ_INFO(pass_by_ref, name, classname, allow_null) { #name, sizeof(#name)-1, #classname, sizeof(#classname)-1, 0, allow_null, pass_by_ref, 0, 0 }, #define ZEND_ARG_ARRAY_INFO(pass_by_ref, name, allow_null) { #name, sizeof(#name)-1, NULL, 0, 1, allow_null, pass_by_ref, 0, 0 }, #define ZEND_BEGIN_ARG_INFO_EX(name, pass_rest_by_reference, return_reference, required_num_args) / zend_arg_info name[] = { / { NULL, 0, NULL, 0, 0, 0, pass_rest_by_reference, return_reference, required_num_args }, #define ZEND_BEGIN_ARG_INFO(name, pass_rest_by_reference) / ZEND_BEGIN_ARG_INFO_EX(name, pass_rest_by_reference, ZEND_RETURN_VALUE, -1) #define ZEND_END_ARG_INFO() };

 

以ZEND_BEGIN_ARG_INFO宏定义开始，以ZEND_END_ARG_INFO()结束，这两个宏定义解释如下：

ZEND_BEGIN_ARG_INFO(name, pass_rest_by_reference)：
    开始参数块定义，pass_rest_by_reference为1时，强制所有参数为引用类型
ZEND_END_ARG_INFO() ：
    结束参数块定义

而每一个参数的定义可以是下列宏定义中的一个：

ZEND_ARG_INFO	声明普通参数
ZEND_ARG_OBJ_INFO	声明对象类型的参数
ZEND_ARG_ARRAY_INFO	声明数组类型的参数
ZEND_ARG_PASS_INFO(pass_by_ref)	pass_by_ref为1时，强制设置后续的参数为引用类型

 

所以 对于上面arg_say_hello参数的定义， 展开之后就是

static const zend_arg_info arg_user_login[] = { / { NULL, 0, NULL, 0, 0, 0, 0, 0, 0 }, { "name", sizeof(“name“)-1, NULL, 0, 0, 0, 0, 0, 0 }, }

 

可以看到，其实我们定义参数信息展开后就是一个zend_arg_info结构数组，zend_arg_info结构定义如下：

typedef struct _zend_arg_info { char *name; zend_uint name_len; char *class_name; zend_uint class_name_len; zend_bool array_type_hint; zend_bool allow_null; zend_bool pass_by_reference;