PHP 7.0扩展开发报错：zend_unwrap_reference未声明如何解决？

这个错误是因为编译器找不到zend_unwrap_reference函数的声明，主要有两个常见原因和对应的解决方法：

1. 缺失必要的头文件引用 #

zend_unwrap_reference函数是在zend_API.h头文件中声明的，很多PHP扩展默认只包含php.h，但php.h并不会自动引入所有Zend引擎的API头文件。

解决方法：在你的扩展源码文件顶部，添加对zend_API.h的引用：

#include "php.h"
#include "zend_API.h" // 加上这一行

2. 直接使用等价的手动解引用逻辑 #

如果添加头文件后仍然有问题（比如某些特殊编译环境下函数不可见），你可以手动实现zend_unwrap_reference的核心逻辑——循环解引用直到拿到原始值。这个函数的本质就是循环获取引用指向的实际zval，所以可以用这段代码替代：

// 替代 zend_unwrap_reference(&retval); 的逻辑
while (Z_ISREF_P(retval)) {
    retval = Z_REF_P(retval);
}

这段代码会持续检查当前zval是否是引用类型，如果是，就获取它指向的实际zval，直到处理到非引用的zval为止，和zend_unwrap_reference的行为完全一致。

内容的提问来源于stack exchange，提问作者Anamul Hasan