PHP 확장 기능의 매개변수 전달 및 매개변수 획득 예제에 대한 자세한 설명

머리말

이전 글에서 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的一样，可以无限传参数进去的函数的实现 区别与特点 1.用于应对无限参数的扩展函数的实现。 2.zend_get_parameters_array与zend_get_parameters_array_ex唯一不同的是它将zval*类型的参数填充到args中，并且需要ZEND_NUM_ARGS()作为参数。 综合评价:当遇到确实需要处理无限参数的时候，真的要用这个函数了。zend_parse_parameters真的做不到啊～ 总结 抛开一切，最少也要学会zend_parse_parameters()的用法。好的。扩展函数传参数的技能get了。

위 내용은 PHP 확장 기능의 매개변수 전달 및 매개변수 획득 예제에 대한 자세한 설명의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!