머리말

이전 글에서 php 확장의 확장 프레임워크 자동 생성을 마치고 나면 php 확장 프레임워크에 대한 전반적인 이해가 되었다고 볼 수 있습니다. 그리고 핵심 사항이지만 여전히 핵심은 PHP_FUNCTION의 함수를 작성하는 방법입니다.
이 글에서는 주로 확장 기능을 호출할 때 PHP가 매개 변수를 전달하는 방법을 기록하는데, 확장 기능은 어떻게 호출을 수신하나요? 나만의 메모

Text

1.zend_parse_parameters

함수가 전달한 매개변수를 얻으려면 zend_parse_parameters 함수를 사용하면 됩니다. 주의깊은 학생들은 공식적으로 생성된 기본 함수도 이 함수를 사용하여 매개변수를 받는다는 것을 알게 될 것입니다.

이 기능을 어떻게 사용하나요?

우선 이 책을 PHP의 scanf처럼 읽어서 사용할 수 있습니다. (이 함수에 익숙하지 않으신 분들은 여기에서 편하게 읽어주세요)

zend_parse_parameters(int num_args TSRMLS_DC, char *type_spec, &参数1,&参数2…);

로그인 후 복사

첫 번째 매개변수는 함수에 전달되는 매개변수 개수입니다. 일반적인 접근 방식은 ZEND_NUM_ARGS()를 전달하는 것입니다. (ZEND_NUM_ARGS() 전달된 "매개변수가 있는 만큼"을 표현하기 위한 매크로입니다.) 함수에 전달된 전체 매개변수 개수를 나타내는 매크로입니다.

두 번째 매개변수는 스레드 안전을 위한 것으로 항상 TSRMLS_CC 매크로를 전달합니다.

세 번째 매개변수는 함수에서 예상하는 매개변수 유형을 지정하는 문자열이며, 그 뒤에 매개변수 값으로 업데이트해야 하는 변수 목록이 옵니다. PHP는 약한 유형의 언어이기 때문에 느슨한 변수 정의와 동적 유형 판단을 사용하는 반면 C 언어는 강력한 유형의 언어이므로 zend_parse_parameters()는 다양한 유형의 매개변수를 예상 유형으로 변환합니다. (실제값을 예상되는 타입으로 강제할 수 없는 경우 경고 발생)

네 번째, 다섯 번째, n번째 매개변수는 모두 전달되는 값의 값입니다.

세 번째 매개변수에 대한 자세한 설명

세 번째 매개변수에 대한 선택 매개변수 목록은 다음과 같습니다.

여기서 특별히 주의해야 할 점이 두 가지 있습니다

zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s",&name, &name_len)

로그인 후 복사

2. 간단히 알아야 할 점, zval이 무엇인가요? zval은 Zend 엔진의 가치 컨테이너입니다. 변수가 부울, 문자열 또는 기타 유형인지 여부에 관계없이 해당 정보는 항상 zval 공용체에 포함됩니다. zval의 구조를 살펴보겠습니다. ps: 이미 누군가가 잘 작성한 것을 확인했기 때문에 설명하지 않겠습니다. typedef 사용법 요약을 클릭하세요. 여기에도 세 가지가 포함됩니다. 매개변수 수신 기능을 강화하려면:

유형 지정자	해당 C 유형	설명
l	long	부호 있는 정수
d	double	부동 소수점
s	char *, int	이진 문자열, 길이
b	zend_ bool	논리 유형( 1 또는 ) 모든 유형 개체
O	zval *	지정된 유형의 개체입니다. 아무런 연산 없이
z	zval *	zval을 제공해야 합니다
	1에 해당하는 두 가지 c 유형이 있습니다. 여기에 문자열 유형을 입력하세요. 예. 이는 zend_parse_parameters() 함수를 사용할 때 다음과 같이 사용해야 함을 보여줍니다.	하나는 문자열 내용을 나타내고 다른 하나는 문자열 길이를 나타냅니다.
typedef union _zval { long lval; double dval; struct { char val; int len; } str; HashTable ht; zend_object_value obj; } zval; 로그인 후 복사
Symbol	Explanation

앞의 매개변수는 모두 필요하고 뒤의 매개변수는 필요하지 않습니다. 기본값을 갖습니다.

PHP 언어에서 null 변수를 받으면 이를 IS_NULL 형식의 zval로 캡슐화하지 않고 C 언어에서 직접 NULL로 변환합니다.

/전달된 변수가 다른 변수와 zval을 공유하고 참조가 아닌 경우 새 zval의 is_ref__gc==0 및 refcount__gc==1이 강제로 분리됩니다.

“|”和”!”将在下文有具体例子讲解，关于”/”虽然大概懂意思，但没想到具体的例子。

走一波与php的交互

正常的样子

在PHP中

<?phpfunction my_function($msg) {
    echo "我收到参数啦： {$msg}!\n";
}
my_function(&#39;咖啡色的羊驼&#39;);

로그인 후 복사

如果my_function写成PHP扩展：

ZEND_FUNCTION(my_function) {
    char *msg;
    int msg_len;

    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s",&msg, &msg_len) == FAILURE){
        RETURN_NULL();
    }
    php_printf("我收到参数啦：");
    PHPWRITE(msg, msg_len);
    php_printf("!\n");
}

로그인 후 복사

两个参数的样子

在PHP中

<?phpfunction my_function($email, $msg) {
    echo "我收到参数啦： {$email}、 {$msg}!\n";
}
my_function(&#39;123456@qq.com&#39;, &#39;咖啡色的羊驼&#39;);

로그인 후 복사

如果my_function写成PHP扩展：

ZEND_FUNCTION(my_function) {
    char *email;
    int email_len;
    char *msg;
    int msg_len;

    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss",&msg, &msg_len,&email, &email_len) == FAILURE){
        RETURN_NULL();
    }
    php_printf("我收到参数啦：");
    PHPWRITE(email, email_len);
    PHPWRITE(msg, msg_len);
    php_printf("!\n");
}

로그인 후 복사

两个参数,其中一个可选且有默认值

<?phpfunction my_function($email, $msg = &#39;咖啡色的羊驼&#39;) {
    echo "我收到参数啦： {$email}、 {$msg}!\n";
}
my_function(&#39;123456@qq.com&#39;);

로그인 후 복사

如果my_function写成PHP扩展：

ZEND_FUNCTION(my_function) {
    char *email;
    int email_len;
    char *msg = "咖啡色的羊驼";
    int msg_len = sizeof("咖啡色的羊驼") - 1;

    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|s",&msg, &msg_len,&email, &email_len) == FAILURE){
        RETURN_NULL();
    }
    php_printf("我收到参数啦：");
    PHPWRITE(email, email_len);
    PHPWRITE(msg, msg_len);
    php_printf("!\n");
}

로그인 후 복사

这里说明了”｜”的使用

参数为null时，省内存的写法

先来不省的写法

ZEND_FUNCTION(my_function) {
    zval *val;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z",&val) == FAILURE) {
        RETURN_NULL();
    }
}

로그인 후 복사

省内存

ZEND_FUNCTION(my_function) {
    zval *val;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z!",&val) == FAILURE) {
        RETURN_NULL();
    }
}

로그인 후 복사

这里例子用上了”!”，每个zval，包括IS_NULL型的zval，都需要占用一定的内存空间，需要cpu的计算资源来为它申请内存、初始化，并在它们完成工作后释放掉。但是很多代码都都没有意识到这一点。有很多代码都会把一个null型的值包裹成zval的IS_NULL类型，在扩展开发里这种操作是可以优化的，我们可以把参数接收成C语言里的NULL。
所以就差了一个！，第二个例子就更省了内存。

2.zend_get_arguments()

用法

例子是最好的用法讲解，上例子：

ZEND_FUNCTION(my_function) {
    zval *email;    if (zend_get_parameters(ZEND_NUM_ARGS(), 1, &email)== FAILURE) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,"至少需要一个参数");
        RETURN_NULL();
    }
    // ... }

로그인 후 복사

区别与特点

1.能够兼容老版本的PHP，并且只以zval为载体来接收参数。
2.直接获取，而不做解析，不会进行类型转换，所有的参数在扩展实现中的载体都需要是zval类型的。
3.接受失败的时候，不会自己抛出错误，也不能方便的处理有默认值的参数。
4.会自动的把所有符合copy-on-write的zval进行强制分离，生成一个崭新的copy送到函数内部。

综合评价：还是用zend_parse_parameters吧，这个函数了解下即可，不给力。

3.zend_get_parameters_ex()

用法

ZEND_FUNCTION(my_function) {
    zval **msg;    if (zend_get_parameters_ex(1, &msg) == FAILURE) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,"至少需要一个参数");
        RETURN_NULL();
    }
    // ...}

로그인 후 복사

不需要ZEND_NUM_ARGS()作为参数，因为它是在是在后期加入的，那个参数已经不再需要了。

区别与特点

1.此函数基本同zend_get_parameters()。
2.唯一不同的是它不会自动的把所有符合copy-on-write的zval进行强制分离，会用到老的zval的特性

综合评价：极端情况下可能会用到，这个函数了解下即可。

zend_get_parameter_**

这个包括：zend_get_parameters_array_ex()和zend_get_parameters_array()

用法

ZEND_FUNCTION(var_dump) {
    int i, argc = ZEND_NUM_ARGS();
    zval ***args;

    args = (zval ***)safe_emalloc(argc, sizeof(zval **), 0);
    if (ZEND_NUM_ARGS() == 0 || zend_get_parameters_array_ex(argc, args) == FAILURE) {
        efree(args);
        WRONG_PARAM_COUNT;
    }
    for (i=0; i<argc; i++) {
        php_var_dump(args[i], 1 TSRMLS_CC);
    }
    efree(args);
}

로그인 후 복사

这个有点复杂，需要解释一下：
程序首先获取参数数量，然后通过safe_emalloc函数申请了相应大小的内存来存放这些zval**类型的参数。这里使用了zend_get_parameters_array_ex()函数来把传递给函数的参数填充到args中。
是的
这个参数专门用于解决像php里面的var_dump的一样，可以无限传参数进去的函数的实现