实例讲解PHP7扩展开发之传参与返回值

什么是PHP扩展?

PHP扩展是指使用C/C++等语言编写的动态链接库，用于扩展PHP本身的功能。PHP扩展提供了一种有效的方式来向PHP引擎添加“内核级别”的功能。常见的PHP扩展包括redis、mysqli、pdo等，它们提供了对不同的服务和数据库的访问支持，同时避免了PHP自身性能不足的问题。

PHP扩展如何传参与返回值?

PHP扩展是C/C++语言编写的，与PHP代码的交互需要使用Zend引擎提供的API，因此扩展的传参和返回值也要使用Zend引擎提供的API函数。下面我们来看看示例代码:

static zval *my_function(zval *param1, zval *param2) {
    zval *return_value;
    ZVAL_NEW_ARRARY(return_value);
    add_assoc_string(return_value, "key1", "value1");
    add_index_string(return_value, "value2");
    return return_value;
}

以上示例代码演示了一个函数my_function的传参和返回值操作。该函数接受两个参数param1和param2，返回一个数组。其中，ZVAL_NEW_ARRARY用于创建一个新的数组作为返回值，add_assoc_string和add_index_string用于向数组中添加元素。在这个例子中，我们可以得到一个类似于{"key1":"value1", "value2"}的数组作为返回值。

扩展开发时应注意什么?

在PHP扩展开发时，我们需要遵守一些规范。首先是函数命名，我们需要遵循zif_{function_name}的命名方式。其次是参数的传递方式，我们需要根据函数的需要进行判断使用哪种传参方式，如使用zval *来接收PHP的参数，还是使用直接类型的传参方式等。第三是返回值的处理，我们在函数中需要使用ZVAL_*宏来创建返回值变量，并在函数结束前使用RETURN_ZVAL_宏将其返回。最后，我们还需要避免内存泄漏、资源泄漏等问题，这可能会导致PHP程序崩溃或内存泄漏等问题。

扩展开发示例

下面我们以一个加法运算函数的扩展为示例来演示如何开发PHP扩展。该扩展接受两个数字参数并返回它们的和。

// 定义一个zif_add_function函数，注意函数命名要以zif_开头
ZEND_FUNCTION(zif_add_function) {
    // 定义变量用于接收PHP传递的参数
    long param1, param2;
    // 使用zend_parse_parameters函数解析PHP传递的参数
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ll", ¶m1, ¶m2) == FAILURE) {
        RETURN_NULL();
    }
    // 定义变量sum用于保存计算结果
    long sum = param1 + param2;
    // 使用ZVAL_LONG宏定义返回值变量
    zval *result;
    ZVAL_LONG(result, sum);
    // 返回结果
    RETURN_ZVAL(result, 1, 0);
}

// 定义add_functions数组，用于将扩展中的函数注册到PHP中
zend_function_entry add_functions[] = {
    ZEND_FE(zif_add_function, NULL)
    {NULL, NULL, NULL}
};

// 定义zend_module_entry结构体
zend_module_entry add_module_entry = {
#if ZEND_MODULE_API_NO >= 20010901
    STANDARD_MODULE_HEADER,
#endif
    PHP_ADD_MODULE_NAME,
    add_functions,
    NULL,
    NULL,
    NULL,
    NULL,
    NULL,
#if ZEND_MODULE_API_NO >= 20010901
    PHP_ADD_MODULE_VERSION,
#endif
    STANDARD_MODULE_PROPERTIES
};

// 使用宏将add_module_entry注册到PHP中
ZEND_GET_MODULE(add)

我们可以将以上代码封装为一个名为"add"的PHP扩展，并在PHP程序中使用"add"扩展提供的add_function来进行加法计算。