开发PHP扩展需通过Zend API操作：一、定义并注册zend_module_entry；二、实现MINIT/MSHUTDOWN管理资源；三、用zend_function_entry导出函数并解析参数；四、安全操作zval；五、注册类及对象生命周期回调。
如果您在开发PHP扩展时需要与Zend引擎进行底层交互，则必须通过Zend API提供的函数和宏来操作PHP的内部数据结构。以下是使用Zend API调用的关键步骤：
一、初始化扩展结构体并注册模块
每个PHP扩展都需定义一个zend_module_entry结构体，用于向Zend引擎声明扩展的基本信息、生命周期回调及函数列表。该结构体是扩展被加载和识别的前提。
1、在扩展源码中声明zend_module_entry变量，填入扩展名称、函数数组指针、MINIT/MINFO等回调函数地址。
2、使用ZEND_GET_MODULE宏包裹模块结构体定义，确保在Windows下正确导出符号。
立即学习“PHP免费学习笔记（深入）”；
3、在config.w32或configure.ac中添加编译配置，使phpize能识别并生成对应构建规则。
二、实现MINIT和MSHUTDOWN生命周期函数
MINIT（Module Initialization）在Web服务器启动或CLI脚本首次执行时调用，用于初始化全局资源；MSHUTDOWN在模块卸载前执行，负责释放MINIT中分配的内存或句柄。
1、在MINIT函数中调用REGISTER_INI_ENTRIES()注册INI配置项，或使用zend_register_ini_entries()手动注册。
2、在MINIT中调用zend_register_extension()（如需）或初始化全局哈希表、静态指针等运行时依赖。
3、在MSHUTDOWN中调用UNREGISTER_INI_ENTRIES()清除INI注册，并释放MINIT中malloc分配的内存。
三、定义并导出用户空间函数
通过zend_function_entry数组声明C函数与PHP函数名的映射关系，使这些函数可在PHP脚本中直接调用。Zend API提供宏简化参数解析与返回值设置。
1、定义zend_function_entry数组，每项包含PHP函数名、对应C函数指针、参数信息结构体指针。
2、在C函数体内使用ZEND_PARSE_PARAMETERS_START宏开始参数解析，指定必选/可选参数数量及类型。
3、使用RETURN_STR、RETURN_LONG、RETURN_FALSE等宏设置返回值，避免直接操作return_value结构体成员。
四、操作zval与PHP变量类型
zval是PHP中所有变量的底层表示结构，Zend API提供一系列宏和函数用于安全读写zval内容，防止类型混淆或内存越界。
1、使用Z_TYPE_P、Z_STRVAL_P等宏获取zval的类型和值，禁止直接访问zval.u结构体字段。
2、使用ZVAL_STRING、ZVAL_LONG等宏初始化zval，确保引用计数和类型标记正确设置。
3、对字符串类zval执行修改前，调用Z_TRY_MAKE_REALY_WRTIEABLE宏确保其为可写副本，避免修改共享字符串导致不可预知行为。
五、管理资源与对象
当扩展需封装C结构体为PHP对象时，必须注册zend_class_entry并实现create_object、free_obj等处理函数，由Zend引擎统一管理内存生命周期。
1、调用INIT_CLASS_ENTRY宏初始化类结构体，填入类名、方法数组、属性信息。
2、调用zend_register_internal_class_ex注册类，指定父类（如NULL）及构造/析构回调。
3、在create_object回调中调用zend_object_alloc分配对象内存，并将自定义结构体挂载到obj->properties中，确保zend_objects_store_add()在对象创建后被隐式调用。
