php-extension - 如何升级 PHP 函数参数以使用新的 Zend API？

Question

我正在开发一个 php 扩展以将其升级到 PHP7，我的问题是关于 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 中，大多数指向 zvals (zval*) 的指针在 PHP 5 中变成了普通的 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 .