php7 arg info,PHP内核

前一部分内容抄自振宇哥的博客: 旷绝一世, 在此基础后续扩写一部分

我们在写扩展的时候很常见的这样的宏，就比如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看到几次修复, 而且并没有看到任何扩展使用了它, 如果要使用, 需要添加一些版本判断, 实在麻烦, 而且指不定会出什么问题, 这个需求也不是特别重要, 而且全部使用它工程量挺大的, 可能需要过一阵子再考虑统一添加一下