如何升级 PHP 功能参数与新 Zend API 一起使用？

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 函数，其中 returns 一个数组，它看起来像这样： `

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 中，在 PHP 5 中大多数指向 zvals (zval*) 的指针都变成了普通的 zval 结构 (zval) - 而不是传递指针到堆分配的 (emalloc) zvals，zvals 本身被复制。因此，在某种意义上，return_value 是新的 return_value_ptr，因为到处都少了一个间接级别。

因此，逐行查看：

第 1 行：

zval* myArray;

在PHP7中，你不持有一个指向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 包含指向字符串、数组或其他堆分配对象的指针，您将需要使用 zval_dtor();。但在本例中它只是一个空值，因此您不需要运行它。进行中：

第 5 行：

*return_value_ptr = myArray;

现在应该是：

*return_value = myArray;

但是，虽然您可以在这里直接覆盖return_value，但建议为此使用ZVAL_COPY_VALUE宏：

ZVAL_COPY_VALUE(return_value, &myArray);

更好的是，您可以使用 RETVAL_ZVAL 这是设置 return 值的快捷方式：

RETVAL_ZVAL(&myArray);

我应该指出，在这种情况下您可能不需要 myArray zval，因为您可以将数组直接存储在 return_value 中，而不必稍后复制它。要记住的另一件事是您可能应该处理参数。如果你什么都不拿，zend_parse_parameters_none();就够了。

我建议阅读 phpng upgrading guide and the internals upgrading guide。

如何升级 PHP 功能参数与新 Zend API 一起使用？

How to upgrade PHP function parameters work with new Zend API?

php-extension

php-internals

php-7