前一部分内容抄自振宇哥的博客: 旷绝一世, 在此基础后续扩写一部分
我们在写扩展的时候很常见的这样的宏,就比如swoole扩展中:1
2
3
4
5ZEND_BEGIN_ARG_INFO_EX(arginfo_swoole_server_listen, 0, 0, 3)//名字,unused,引用返回,参数个数
ZEND_ARG_INFO(0, host)
ZEND_ARG_INFO(0, port)
ZEND_ARG_INFO(0, sock_type)
ZEND_END_ARG_INFO()
这个宏组合是用来定义函数的参数,我们不妨去跟下ZEND_BEGIN_ARG_INFO_EX 与ZEND_END_ARG_INFO的定义。
定义在zend_API.h文档中,ZEND_BEGIN_ARG_INFO_EX的定义为:1
2
3static const zend_internal_arg_info name[] = {
{(const char*)(zend_uintptr_t)(required_num_args), 0, return_reference, 0 },
ZEND_END_ARG_INFO的定义为:1
那么组合起来变成c代码就是
1
2
3
4
5
6static const zend_internal_arg_info arginfo_swoole_server_listen[] = {
{3, 0, 0, 0 },
{ host, 0, 0, 0},
{ port, 0, 0, 0},
{ sock_type, 0, 0, 0},
}
现在看来就是定义了一个zend_internal_arg_info结构数组,在zend/zend_compile.h文档中定义:1
2
3
4
5
6
7
8typedef struct _ {
const char *name;
const char *class_name;
zend_uchar type_hint;
zend_uchar pass_by_reference;
zend_bool allow_null; //是否允许设置为空
zend_bool is_variadic;//**是否为可变参数**
} zend_internal_arg_info;
PHP7中还加入了返回值类型声明这一新特性, 但是到目前为止, 各种扩展几乎没有添加返回值声明的意思, 但是这一特性对于IDE提示的生成非常有帮助1
2
3
4
5
6#define ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(name, return_reference, required_num_args, type, allow_null)
static const zend_internal_arg_info name[] = {
{ (const char*)(zend_uintptr_t)(required_num_args), ZEND_TYPE_ENCODE(type, allow_null), return_reference, 0 },
#define ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO(name, type, allow_null)
ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(name, 0, -1, type, allow_null)
在ZEND API头文档中我们可以看到新添加的宏ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX, 还有ZEND_BEGIN_ARG_WITH_RETURN_OBJ_INFO_EX等等
我们可以这样使用它1
2
3
4
5ZEND_BEGIN_ARG_WITH_RETURN_OBJ_INFO_EX(arginfo_swoole_http2_client_coro_recv, 0, 1, Swoole\Http2\Response, 0)
ZEND_END_ARG_INFO()
ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO(arginfo_swoole_http2_client_coro_balabala, _IS_BOOL, 0)
ZEND_END_ARG_INFO()
这样就可以为这个方法声明返回值类型了
当然, 我实际并没有这么做, 因为好像ZEND_BEGIN_ARG_WITH_RETURN_OBJ_INFO_EX这个宏在PHP7最初版本有BUG, 我们可以通过git blame看到几次修复, 而且并没有看到任何扩展使用了它, 如果要使用, 需要添加一些版本判断, 实在麻烦, 而且指不定会出什么问题, 这个需求也不是特别重要, 而且全部使用它工程量挺大的, 可能需要过一阵子再考虑统一添加一下