如何使用新的Zend API升级PHP函数参数？

Question

我正在开发一个php扩展,将其升级到PHP7,我的问题是关于INTERNAL_FUNCTION_PARAMETERS.在之前的版本中,它被定义为:

INTERNAL_FUNCTION_PARAMETERS int ht, zval *return_value, zval **return_value_ptr, zval *this_ptr, int return_value_used TSRMLS_DC

在新的zend引擎中,它被定义为:

INTERNAL_FUNCTION_PARAMETERS zend_execute_data *execute_data, zval *return_value

我有php函数,它返回一个数组,它看起来像这样:`

PHP_FUNCTION( myFunc ){ zval* myArray;
   array_init(myArray);
   /////
   zval_ptr_dtor( &return_value );
   *return_value_ptr = myArray;
}

如果没有hanvig我应该如何获得类似的功能return_value_ptr？我应该使用#define RETURN_ARR(r)？,如果是这样,这对性能有何影响？

Answer 1

在PHP 7中,zval*PHP 5中大多数指向zvals()的指针已成为普通的zval结构(zval) - 而不是将指针传递给堆分配的(emalloc)zval,而是复制了zval本身.因此,从某种意义上说,这 return_value是新的return_value_ptr,因为到处都有一个较少的间接层.

所以,逐行完成:

第1行:

zval* myArray;

在PHP 7中,您没有指向zval的指针,而是将其直接放在堆栈上.没有外部分配.所以你的函数的第一行应该是:

zval myArray;

第2行:

array_init(myArray);

array_init需要一个指向zval(zval*)的指针,所以这应该是:

array_init(&myArray);

第4行:

zval_ptr_dtor( &return_value );

同样,PHP 7在这里删除了一个间接级别.现在就是这样:

zval_dtor(return_value);

但是,在PHP 7中不需要这一行.zval不需要解除分配(实际上你不能解除分配),你可以简单地覆盖它.您将需要使用zval_dtor();,如果zval的含有指向字符串的指针,数组或其他一些堆分配的对象,虽然.但在这种情况下,它只是一个null,所以你不需要运行它.继续:

第5行:

*return_value_ptr = myArray;

现在应该是:

*return_value = myArray;

但是,虽然您可以直接return_value在此处覆盖,但建议您使用此ZVAL_COPY_VALUE宏:

ZVAL_COPY_VALUE(return_value, &myArray);

更好的是,您可以使用RETVAL_ZVAL哪个是设置返回值的快捷方式:

RETVAL_ZVAL(&myArray);

我应该指出,myArray在这种情况下你可能不需要zval,因为你可以return_value直接存储数组,而不必在以后复制它.另外要记住的是你应该处理参数.如果你不采取任何,zend_parse_parameters_none();就足够了.

我建议阅读phpng升级指南和内部升级指南.