PHP扩展参数传递主要有五种方式：一、用ZEND_PARSE_PARAMETERS宏解析标量等类型；二、直接通过zval*访问参数数组；三、支持可选参数与默认值；四、处理引用参数需识别并修改zval；五、校验对象类名或资源类型确保安全。
PHP扩展在实现函数时需要从用户空间接收参数，这些参数可能为标量、数组、对象或资源类型。以下是几种常见的PHP扩展参数传递方式及其实现示例：
一、使用ZEND_PARSE_PARAMETERS宏解析参数
ZEND_PARSE_PARAMETERS宏是PHP 7.0之后推荐的参数解析方式，支持类型声明与数量校验，安全性高且语法简洁。
1、在函数实现中调用zend_parse_parameters或ZEND_PARSE_PARAMETERS_START宏。
2、声明参数类型符号，例如"s"表示字符串，"l"表示长整型，"a"表示数组，"z"表示zval通用类型。
立即学习“PHP免费学习笔记（深入）”；
3、传入对应C变量地址，如&str、&len、&arr。
4、在ZEND_PARSE_PARAMETERS_END()后检查返回值是否为FAILURE以判断解析失败。
二、通过zval*直接访问参数数组
在旧版扩展或需动态处理参数时，可直接操作execute_data->This和execute_data->args，适用于变参函数或运行时类型判断场景。
1、获取参数总数：uint32_t argc = ZEND_CALL_NUM_ARGS(execute_data)。
2、获取第i个参数指针：zval *arg = ZEND_CALL_ARG(execute_data, i + 1)。
3、使用Z_TYPE_P(arg)判断类型，再用Z_STRVAL_P、Z_LVAL_P等宏提取值。
4、对zval进行引用计数管理，必要时调用Z_TRY_ADDREF_P(arg)。
三、支持可选参数与默认值设定
PHP扩展可通过在ZEND_PARSE_PARAMETERS宏中使用|分隔符定义可选参数，并为后续参数提供默认初始化值。
1、在宏中写入形如"s|l"表示第一个参数必填字符串，第二个为可选长整型。
2、声明C变量时对可选参数赋予初始值，例如zend_long times = 1。
3、解析后仅当参数实际传入时，对应变量才被覆盖；否则保留初始化值。
4、注意：可选参数必须位于必需参数之后，且不可跳过中间参数。
四、传递并修改引用参数
当PHP函数声明形参为引用（如&$var），扩展需识别引用zval并允许原地修改其值。
1、使用"z"类型接收zval指针，再通过Z_ISREF_P(zv)确认是否为引用。
2、若为引用，直接操作Z_REFVAL_P(zv)指向的zval。
3、调用zval_ptr_dtor释放原值，再用ZVAL_LONG等宏写入新值。
4、必须调用Z_DELREF_P(zv)并在必要时ZVAL_COPY构造新zval以避免内存错误。
五、处理对象与资源类型参数
扩展常需接收用户创建的对象实例或资源句柄，此时需校验类名或资源类型标识符。
1、使用"O"接收对象，后跟类名字符串及对应ce指针，如"O:MyClass"。
2、使用"r"接收资源，再通过Z_RES_P(zv)->handler匹配自定义资源处理器。
3、调用zend_fetch_resource2或zend_is_resource进一步验证资源有效性。
4、未通过类型校验的参数将导致zend_parse_parameters抛出TypeError异常。
