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 중국어 웹사이트의 기타 관련 기사를 참조하세요! 본 웹사이트의 성명 본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요. 핫 AI 도구 Undresser.AI Undress 사실적인 누드 사진을 만들기 위한 AI 기반 앱 AI Clothes Remover 사진에서 옷을 제거하는 온라인 AI 도구입니다. Undress AI Tool 무료로 이미지를 벗다 Clothoff.io AI 옷 제거제 AI Hentai Generator AI Hentai를 무료로 생성하십시오. 더보기 인기 기사 어 ass 신 크리드 그림자 : 조개 수수께끼 솔루션 3 몇 주 전 By DDD Windows 11 KB5054979의 새로운 기능 및 업데이트 문제를 해결하는 방법 2 몇 주 전 By DDD Atomfall에서 크레인 제어 키 카드를 찾을 수 있습니다 3 몇 주 전 By DDD R.E.P.O. 저축 설명 (및 파일 저장) 1 몇 달 전 By 尊渡假赌尊渡假赌尊渡假赌 어 ass 신 크리드 섀도우 - 대장장이를 찾고 무기 및 갑옷 커스터마 화 잠금 해제 방법 4 몇 주 전 By DDD 더보기 뜨거운 도구 메모장++7.3.1 사용하기 쉬운 무료 코드 편집기 SublimeText3 중국어 버전 중국어 버전, 사용하기 매우 쉽습니다. 스튜디오 13.0.1 보내기 강력한 PHP 통합 개발 환경 드림위버 CS6 시각적 웹 개발 도구 SublimeText3 Mac 버전 신 수준의 코드 편집 소프트웨어(SublimeText3) 더보기 뜨거운 주제 Gmail 이메일의 로그인 입구는 어디에 있나요? 7569 15 Cakephp 튜토리얼 1386 52 Steam의 계정 이름 형식은 무엇입니까? 87 11 Win11 활성화 키 영구 61 19 NYT 연결 힌트와 답변 28 107 더보기 Related knowledge Ubuntu 및 Debian용 PHP 8.4 설치 및 업그레이드 가이드 Dec 24, 2024 pm 04:42 PM PHP 8.4는 상당한 양의 기능 중단 및 제거를 통해 몇 가지 새로운 기능, 보안 개선 및 성능 개선을 제공합니다. 이 가이드에서는 Ubuntu, Debian 또는 해당 파생 제품에서 PHP 8.4를 설치하거나 PHP 8.4로 업그레이드하는 방법을 설명합니다. PHP 개발을 위해 Visual Studio Code(VS Code)를 설정하는 방법 Dec 20, 2024 am 11:31 AM VS Code라고도 알려진 Visual Studio Code는 모든 주요 운영 체제에서 사용할 수 있는 무료 소스 코드 편집기 또는 통합 개발 환경(IDE)입니다. 다양한 프로그래밍 언어에 대한 대규모 확장 모음을 통해 VS Code는 이전에 몰랐던 후회되는 PHP 함수 7가지 Nov 13, 2024 am 09:42 AM 숙련된 PHP 개발자라면 이미 그런 일을 해왔다는 느낌을 받을 것입니다. 귀하는 상당한 수의 애플리케이션을 개발하고, 수백만 줄의 코드를 디버깅하고, 여러 스크립트를 수정하여 작업을 수행했습니다. PHP에서 HTML/XML을 어떻게 구문 분석하고 처리합니까? Feb 07, 2025 am 11:57 AM 이 튜토리얼은 PHP를 사용하여 XML 문서를 효율적으로 처리하는 방법을 보여줍니다. XML (Extensible Markup Language)은 인간의 가독성과 기계 구문 분석을 위해 설계된 다목적 텍스트 기반 마크 업 언어입니다. 일반적으로 데이터 저장 AN에 사용됩니다 JWT (JSON Web Tokens) 및 PHP API의 사용 사례를 설명하십시오. Apr 05, 2025 am 12:04 AM JWT는 주로 신분증 인증 및 정보 교환을 위해 당사자간에 정보를 안전하게 전송하는 데 사용되는 JSON을 기반으로 한 개방형 표준입니다. 1. JWT는 헤더, 페이로드 및 서명의 세 부분으로 구성됩니다. 2. JWT의 작업 원칙에는 세 가지 단계가 포함됩니다. JWT 생성, JWT 확인 및 Parsing Payload. 3. PHP에서 인증에 JWT를 사용하면 JWT를 생성하고 확인할 수 있으며 사용자 역할 및 권한 정보가 고급 사용에 포함될 수 있습니다. 4. 일반적인 오류에는 서명 검증 실패, 토큰 만료 및 대형 페이로드가 포함됩니다. 디버깅 기술에는 디버깅 도구 및 로깅 사용이 포함됩니다. 5. 성능 최적화 및 모범 사례에는 적절한 시그니처 알고리즘 사용, 타당성 기간 설정 합리적, 문자열로 모음을 계산하는 PHP 프로그램 Feb 07, 2025 pm 12:12 PM 문자열은 문자, 숫자 및 기호를 포함하여 일련의 문자입니다. 이 튜토리얼은 다른 방법을 사용하여 PHP의 주어진 문자열의 모음 수를 계산하는 방법을 배웁니다. 영어의 모음은 A, E, I, O, U이며 대문자 또는 소문자 일 수 있습니다. 모음이란 무엇입니까? 모음은 특정 발음을 나타내는 알파벳 문자입니다. 대문자와 소문자를 포함하여 영어에는 5 개의 모음이 있습니다. a, e, i, o, u 예 1 입력 : String = "Tutorialspoint" 출력 : 6 설명하다 문자열의 "Tutorialspoint"의 모음은 u, o, i, a, o, i입니다. 총 6 개의 위안이 있습니다 PHP에서 늦은 정적 결합을 설명하십시오 (정적 : :). Apr 03, 2025 am 12:04 AM 정적 바인딩 (정적 : :)는 PHP에서 늦은 정적 바인딩 (LSB)을 구현하여 클래스를 정의하는 대신 정적 컨텍스트에서 호출 클래스를 참조 할 수 있습니다. 1) 구문 분석 프로세스는 런타임에 수행됩니다. 2) 상속 관계에서 통화 클래스를 찾아보십시오. 3) 성능 오버 헤드를 가져올 수 있습니다. php magic 방법 (__construct, __destruct, __call, __get, __set 등)이란 무엇이며 사용 사례를 제공합니까? Apr 03, 2025 am 12:03 AM PHP의 마법 방법은 무엇입니까? PHP의 마법 방법은 다음과 같습니다. 1. \ _ \ _ Construct, 객체를 초기화하는 데 사용됩니다. 2. \ _ \ _ 파괴, 자원을 정리하는 데 사용됩니다. 3. \ _ \ _ 호출, 존재하지 않는 메소드 호출을 처리하십시오. 4. \ _ \ _ get, 동적 속성 액세스를 구현하십시오. 5. \ _ \ _ Set, 동적 속성 설정을 구현하십시오. 이러한 방법은 특정 상황에서 자동으로 호출되어 코드 유연성과 효율성을 향상시킵니다. See all articles 공공복지 온라인 PHP 교육，PHP 학습자의 빠른 성장을 도와주세요！ 회사 소개 부인 성명 Sitemap © php.cn All rights reserved