通过引用将变量传递给PHP扩展

我正在编写一个PHP扩展,它接受一个值并改变它.示例PHP:

$someVal = "input value";
TestPassRef($someVal);
// value now changed

什么是正确的方法？

编辑2011-09-13:正确的方法是使用ZEND_BEGIN_ARG_INFO()宏系列 - 请参阅扩展和嵌入PHP第6章(Sara Golemon,开发人员库).

此示例函数按值(由于ZEND_ARG_PASS_INFO(0)调用)获取一个字符串参数,然后通过引用获取所有其他参数(由于第二个参数为ZEND_BEGIN_ARG_INFO1).

const int pass_rest_by_reference = 1;
const int pass_arg_by_reference = 0;

ZEND_BEGIN_ARG_INFO(AllButFirstArgByReference, pass_rest_by_reference)
   ZEND_ARG_PASS_INFO(pass_arg_by_reference)
ZEND_END_ARG_INFO()

zend_function_entry my_functions[] = {
    PHP_FE(TestPassRef, AllButFirstArgByReference)
};

PHP_FUNCTION(TestPassRef)
{
    char *someString = NULL;
    int lengthString = 0;
    zval *pZVal = NULL;

    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sz", &someString, &lengthString, &pZVal) == FAILURE)
    {
        return;
    }

    convert_to_null(pZVal);  // Destroys the value that was passed in

    ZVAL_STRING(pZVal, "some string that will replace the input", 1);
}

在添加之前,convert_to_null它会在每次调用时泄漏内存(我不知道在添加ZENG_ARG_INFO()调用后是否有必要).