php 7.2扩展开发中，参数获取须先调zend_num_args()再用zend_parse_parameters()按格式解析；zval操作需先判类型（如z_type_p）再取值；返回值须先zval_null()清空，再依类型用对应zval_*宏设置。
你想在PHP 7.2中写一个扩展，但卡在函数参数怎么取、返回值怎么设——不是靠var_dump猜，而是真正理解zval结构体怎么拆、类型怎么判、内存怎么管。
获取传入参数：从ZEND_NUM_ARGS()开始
第一步必须调用ZEND_NUM_ARGS()，它返回本次调用实际传入的参数个数。不调这个就直接读参数，轻则读错zval地址，重则触发段错误崩溃。
接着调用zend_parse_parameters()，传入ZEND_NUM_ARGS()结果、格式字符串和变量地址。比如要接收一个字符串和一个整数：zend_parse_parameters(ZEND_NUM_ARGS(), "sl", &str, &str_len, &num)。注意s对应char*+size_t，l对应long，顺序错一位整个参数就全乱。
格式字符必须严格匹配：t（boolean）→ zend_bool指针，d（double）→ double*，z（zval*）→ zval**。用错会导致内存越界或类型误判。
处理zval类型：别硬转，先判再取
如果参数是zval*（比如格式字符用z），不能直接访问z->value.lval。必须先用Z_TYPE_P(z)判断类型，否则对NULL或array类型读lval会崩溃。
方法一：用Z_STRVAL_P(z)取字符串前，先确认Z_TYPE_P(z) == IS_STRING；方法二：想取数字又不确定类型，用zval_get_long(z)安全转换，它自动处理string→int、bool→int等隐式转换；方法三：遇到IS_ARRAY，必须用zend_hash_get_current_data_ex()遍历，不能当普通结构体字段读。
【ZVAL_IS_NULL(z)比Z_TYPE_P(z) == IS_NULL更安全，因为前者还检查了z是否为NULL指针】
设置返回值：三种方式选对路径
第一步：清空return_value，调用ZVAL_NULL(return_value)。这步不能省，否则残留旧zval可能引发引用计数错误。
第二步：根据返回类型选写法。返回字符串用ZVAL_STRING(return_value, "ok")；返回整数用ZVAL_LONG(return_value, 123)；返回数组必须先ZVAL_ARR(return_value)，再用zend_hash_str_add()往里面塞元素。
第三步：若需返回新分配的字符串且不希望PHP自动释放，用ZVAL_STRINGL(return_value, str, len)并确保str内存由扩展长期持有；否则用ZVAL_STRING，PHP会在变量销毁时自动free。
返回zval*类型（如对象）时，必须调用ZVAL_OBJ(return_value, obj)，且obj引用计数已+1；若没+1，立刻调用GC_REFCOUNT(obj)++，否则对象可能被提前回收。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
