在 php 扩展开发中，定义自定义函数的入参和返回值类型至关重要，具体步骤包括：定义类型限定符：void 无返回值，基本类型使用 int 等，对象类型使用 arrayobject，任意类型使用 mixed。定义入参类型：使用 zend_arg_info 结构，指定参数名称、类型、是否按引用传递。定义返回值类型：使用 zend_return_reference * 指针，指定类型和是否允许 null。注册自定义函数：使用 zend_register_functions，传入参数和返回值类型信息。
PHP 扩展开发：定义自定义函数入参和返回值类型
在 PHP 扩展开发中，定义自定义函数的入参和返回值类型对于确保安全性和代码稳定性至关重要。以下是步骤：
1. 定义类型限定符
PHP 提供了几个类型限定符，用于指定参数类型和返回值：
- void: 对于不返回值的函数
- int, float, string, bool: 用于基本数据类型
- array
- object: 用于对象
- mixed: 用于可接受任何类型的参数
2. 定义入参类型
入参类型可以使用 zend_arg_info 结构定义：
zend_arg_info arg_info[] = {
{ .name = "argument_name", .type = type, .pass_by_reference = 0 },
// ... 更多参数
{ .name = NULL, .type = 0 }
};
其中：
- argument_name: 参数名称
- type: 类型限定符
- pass_by_reference: 是否按引用传递参数 (默认为 0，按值传递)
3. 定义返回值类型
返回值类型可以使用 zend_return_reference * 指针定义：
zend_return_reference *return_reference;
if (return_value) {
return_reference->type = type;
return_reference->allow_null = 1;
}
其中：
- type: 类型限定符
- allow_null: 是否允许返回值为 null
4. 注册自定义函数
最后，使用 zend_register_functions 函数注册自定义函数，并传入指定的参数和返回值类型信息：
zend_function_entry functions[] = {
{ "my_function_name", ZEND_FN(my_function_name), ZEND_FN(my_function_name), arg_info, return_reference },
// ... 其他函数
};
zend_register_functions(functions, COUNT_OF(functions));
实战案例
让我们编写一个名为 add() 的自定义函数，它接受两个整数参数并返回一个整数。
zend_arg_info arg_info[] = {
{ .name = "num1", .type = IS_LONG, .pass_by_reference = 0 },
{ .name = "num2", .type = IS_LONG, .pass_by_reference = 0 },
{ .name = NULL, .type = 0 }
};
zend_return_reference *return_reference;
return_reference->type = IS_LONG;
return_reference->allow_null = 0;
ZEND_FUNCTION(add) {
long num1, num2;
ZEND_PARSE_PARAMETERS_START(2, 2)
Z_PARAM_LONG(num1)
Z_PARAM_LONG(num2)
ZEND_PARSE_PARAMETERS_END();
RETURN_LONG(num1 + num2);
}
