PHP扩展通过C语言调用Zend API实现与内核交互：可调用PHP函数、注册C函数、操作zval和HashTable、规范内存管理。
PHP扩展通过C语言编写，利用Zend引擎提供的API与PHP内核通信，实现对PHP功能的增强。以下是PHP扩展与C语言交互的核心原理及具体实现方式：
一、使用Zend API调用PHP函数
PHP扩展在C代码中可通过zend_call_function等API执行PHP用户空间定义的函数，实现双向调用。该机制依赖于zend_fcall_info结构体封装调用上下文，并由Zend引擎完成参数传递与返回值处理。
1、声明zend_fcall_info和zend_fcall_info_cache变量，用于存储目标函数信息。
2、调用zend_is_callable判断指定函数名是否可被调用，必须确保函数已加载且作用域可见。
立即学习“PHP免费学习笔记（深入）”；
3、初始化zend_fcall_info结构，设置function_name、retval_ptr_ptr、param_count等字段。
4、调用zend_call_function执行函数，返回值需通过zval类型指针接收并校验类型。
二、在C中定义并注册PHP函数
扩展需通过ZEND_FUNCTION宏定义C函数，并在模块启动时将其注册到函数表，使PHP脚本能直接调用。注册过程由zend_register_functions完成，绑定C函数地址与PHP函数名。
1、使用ZEND_FUNCTION(my_extension_func)声明函数签名，参数通过INTERNAL_FUNCTION_PARAMETERS传入。
2、在函数体内通过ZEND_PARSE_PARAMETERS_START解析参数，必须严格匹配参数数量与类型声明。
3、通过RETURN_STRING、RETURN_LONG等宏设置返回值，避免直接操作return_value导致内存泄漏。
4、在扩展的MINIT函数中调用zend_register_functions，传入函数定义数组及NULL作为模块号。
三、操作zval结构体管理PHP变量
zval是PHP中所有变量的底层表示结构，C扩展通过读写zval字段访问变量值、类型与引用计数。正确操作zval是保证内存安全与类型一致性的关键。
1、使用Z_TYPE_P获取zval指针指向的变量类型，不可直接访问zval.u1.v.type字段。
2、使用Z_STRVAL_P、Z_LVAL_P等宏提取字符串值或整数值，宏内部已处理类型检查与联合体偏移。
3、修改zval值前调用ZVAL_DEREF确保解引用，防止对引用变量误操作原始数据。
4、分配新zval时使用MAKE_STD_ZVAL或emalloc + ZVAL_NULL初始化，未初始化的zval可能导致段错误。
四、使用HashTable操作PHP数组
PHP数组在C层由HashTable结构实现，扩展可通过zend_hash_*系列函数遍历、插入、查找键值对。所有操作均需基于EG(symbol_table)或独立分配的HashTable。
1、获取数组zval后，使用Z_ARRVAL_P提取其HashTable指针。
2、遍历使用zend_hash_get_current_key_ex与zend_hash_get_current_data_ex，需配合hash pointer参数维护迭代位置。
3、插入元素调用zend_hash_str_add或zend_hash_next_index_insert，字符串键需传入长度避免strlen重复计算。
4、删除键值对使用zend_hash_del，删除后原zval内存由GC自动回收，无需手动efree。
五、内存管理与资源生命周期控制
扩展中所有内存分配必须使用Zend内存管理器（emalloc/efree），以兼容PHP的内存跟踪与调试模式。资源对象需注册析构函数，在请求结束时释放。
1、分配字符串缓冲区使用emalloc(strlen(str)+1)，禁止使用malloc避免内存统计失效。
2、注册资源类型调用zend_register_list_destructors_ex，传入析构函数指针与资源名。
3、创建资源调用zend_register_resource，返回资源ID，资源ID在请求结束后自动触发析构。
4、在RSHUTDOWN阶段调用zend_hash_clean清理全局HashTable，防止跨请求残留数据污染。
