在PHP 7.1扩展中操作HashTable需绕过ZEND_API直接访问结构体：初始化时零初始化指针、用_zend_hash_init自动取整容量、设HASH_FLAG_UNINITIALIZED；插入用zend_hash_str_add或手动算hash+next链表查找；删除数值索引须用zend_hash_index_del并置IS_UNDEF；遍历时用迭代器API，禁止zval_copy_ctor。
要在PHP 7.1扩展中安全、高效地操作底层HashTable，必须绕过ZEND_API封装直接调用核心结构体字段和内联函数，否则会因zval布局变更导致内存越界或指针解引用崩溃。
初始化HashTable并预分配空间
第一步：声明HashTable指针并零初始化，避免未初始化的nTableMask引发非法内存访问。
第二步：调用_zend_hash_init时传入0作为nSize参数——这会让PHP自动按2的幂次向上取整到最小合法容量（至少8），【不可传入奇数或小于8的值，否则nTableMask = nTableSize - 1会为负数，后续所有hash计算全部溢出】。
第三步：立即设置ht->u.flags |= HASH_FLAG_UNINITIALIZED，强制标记为未初始化状态，防止在插入前被zend_hash_get_current_key等遍历函数误读pListHead造成段错误。
插入键值对（字符串key）
方法一：使用zend_hash_str_add
直接传入key字符串地址、长度、zval地址三元组，PHP自动计算hash值并处理冲突链；该函数内部会检查key是否已存在，存在则覆盖旧值。
方法二：手动计算hash并定位bucket
先调用zend_string_hash_val(key)获取32位hash值，再用ht->arData + (h & ht->nTableMask)算出起始桶地址；若该位置bucket的key为空或hash不匹配，需沿bucket->next链表线性查找——【注意：PHP 7.1中bucket结构已移除pListNext/pListLast，仅保留next字段用于冲突链，遍历时必须用zend_hash_get_next_data而非手动递进】。
安全删除数值索引元素
第一步：确认目标索引i在有效范围内：i nNumOfElements && i nNextFreeElement，否则跳过。
第二步：调用zend_hash_index_del(ht, i)而非zend_hash_del，前者专用于数字索引，能正确维护nNextFreeElement和pListTail指针关系。
第三步：手动将ht->arData[i].val.type = IS_UNDEF，防止残留zval被GC误判为活跃变量。
遍历HashTable并修改value
① 调用zend_hash_iterator_init获取迭代器句柄，传入ht和0（表示不启用apply protection）。
② 循环调用zend_hash_iterator_move_forward推进指针，每次调用后检查返回值是否为SUCCESS。
③ 在循环体内用zend_hash_get_current_data_ex取出当前bucket的zval指针，直接修改其value.lval或value.str字段——【严禁在此处调用zval_copy_ctor，PHP 7.1的zval已无引用计数，复制会导致double free】。
④ 遍历结束后调用zend_hash_iterator_destroy释放迭代器资源。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
