如何使用新的 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;
}

如果不使用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;

在 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 包含指向字符串、数组或其他一些堆分配对象的指针，您将需要使用zval_dtor();。但在这种情况下，它只是一个空值，所以你不需要运行它。继续：

---

第 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 upgrading guide 和internals upgrading guide。