백엔드 개발 PHP 튜토리얼 PHP 확장 함수에 대한 매개변수 작성

PHP 확장 함수에 대한 매개변수 작성

Dec 07, 2016 pm 03:27 PM
php

함수 매개변수
함수 호출자가 전달한 매개변수를 얻는 가장 간단한 방법은 zend_parse_parameters() 함수를 사용하는 것입니다. 커널의 매크로를 사용하여 zend_parse_parameters() 함수의 처음 몇 개의 매개변수를 ZEND_NUM_ARGS() TSRMLS_CC 형식으로 직접 생성할 수 있습니다. 둘 사이에는 공백이 있지만 쉼표는 없습니다. 이름에서 알 수 있듯이 ZEND_NUM_ARGS()는 매개변수의 개수를 나타냅니다. zend_parse_parameters() 함수에 전달되어야 하는 다음 매개변수는 printf의 첫 번째 매개변수와 마찬가지로 형식 지정에 사용되는 문자열입니다. 가장 일반적으로 사용되는 기호 중 일부는 다음과 같습니다.
type_spec은 형식 문자열이며 일반적인 의미는 다음과 같습니다.
매개변수는 유형을 나타냅니다.
b Boolean
l Integer
d 부동 소수점 부동 소수점
s 문자열 문자열
r 자원 자원
a 배열 배열
o 객체 인스턴스 객체
O 지정된 유형의 객체 인스턴스 특정 유형의 객체
z 비특정 zval 모든 유형 ~
Z zval** type
f는 함수명과 메소드명을 나타내는데 PHP5.1에는 그런게 없는 것 같은데...
이 함수는 printf() 함수와 같습니다. 형식 문자열은 일대일로 대응됩니다. 일부 기본 데이터 유형은 C 언어의 유형에 직접 매핑됩니다.
ZEND_FUNCTION(sample_getlong) {

long foo;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,"l", &foo) == FAILURE)
{
RETURN_ NULL() ;
}
php_printf("매개변수의 정수 값: %ldn", foo);
RETURN_TRUE;
}
일반적으로 int와 long의 두 가지 데이터 유형은 데이터는 동일한 경향이 있지만 예외가 있습니다. 따라서 특히 64비트 플랫폼에서는 긴 배열을 int에 넣어서는 안 됩니다. 그러면 문제 해결이 쉽지 않은 버그가 발생할 수 있습니다. 따라서 zend_parse_parameter() 함수를 통해 매개변수를 수신할 때 커널에서 동의한 유형의 변수를 캐리어로 사용해야 합니다.
매개변수는 C의 데이터 유형에 해당합니다.
b zend_bool
l long
d double
s char*, int 전자는 포인터를 받고, 후자는 길이를 받습니다.
r zval *
a zval*
o zval*
O zval*, zend_class_entry*
z zval*
Z zval**
PHP 언어의 모든 복합 유형 매개변수에는 zval*이 필요합니다. 유형은 커널에 의해 사용자 정의된 일부 데이터 구조이기 때문에 캐리어로 사용됩니다. 매개변수의 유형과 캐리어가 일치하는지 확인해야 합니다. 필요한 경우 배열을 stdClass 객체로 변환하는 등의 유형 변환을 수행할 수 있습니다. s 및 O(유럽 대문자) 유형은 둘 다 두 개의 캐리어가 필요하므로 별도로 설명해야 합니다. 우리는 다음 장에서 PHP의 구체적인 객체 구현에 대해 배울 것입니다. 그럼 5장에서 정의한 함수를 다시 작성해 보겠습니다.
function Sample_hello_world($name) {
echo "Hello $name!n"
}
확장 프로그램을 사용하려면 다음 문자열을 받으려면 zend_parse_parameters()를 사용해야 합니다.
ZEND_FUNCTION(sample_hello_world) {
char *name
int name_len;

if (zend_parse_parameters(ZEND_NUM_ARGS( ) TSRMLS_CC, "s",&name, &name_len) == 실패)
{
RETURN_NULL()
}
php_printf("Hello ")
PHPWRITE(name, name_len); php_printf("!n");
}
함수에 전달된 매개변수 개수가 zend_parse_parameters()에서 수신할 매개변수 개수보다 적으면 실패하고 FAILURE를 반환합니다.
여러 매개변수를 수신해야 하는 경우 다음과 같이 zend_parse_paramenters()의 매개변수에 수신 캐리어를 직접 나열할 수 있습니다.
function Sample_hello_world($name, $greeting) {
echo "Hello $greeting $name!n";
}
sample_hello_world('John Smith', 'Mr.')
이것은 PHP 확장에서 구현되어야 합니다:
ZEND_FUNCTION( Sample_hello_world) {
char *name
int name_len
char *greeting
int Greeting_len;if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss",&name, &name_len, &greeting, &greeting_len) == FAILURE) {
RETURN_NULL();
}
php_printf("Hello "); PHPWRITE(greeting, Greeting_len);
php_printf(" ");
PHPWRITE(name, name_len);
php_printf("!n");
}
위에는 매개변수 수신 기능을 강화하는 세 가지 다른 매개변수가 있습니다.
유형 수정자 의미
| 이전 매개변수는 모두 필요하며 다음 매개변수는 필요하지 않습니다. 즉, 기본값이 있습니다. 가치.
PHP 언어에서 null 변수를 받으면 IS_NULL 유형의 zval로 캡슐화하는 대신 C 언어에서 직접 NULL로 변환합니다.
/ 전달된 변수가 다른 변수와 zval을 공유하고 참조가 아닌 경우 새 zval의 is_ref__gc==0 및 refcount__gc==1이 강제로 분리됩니다.
함수 매개변수의 기본값
이제 계속해서 Sample_hello_world()를 다시 작성하겠습니다. 다음으로 PHP 언어에서 다음과 같은 일부 매개변수의 기본값을 사용합니다. , $greeting=' Mr./Ms.') {
echo "Hello $greeting $name!n"
}
sample_hello_world('Ginger Rogers','Ms.'); Sample_hello_world('Fred Astaire');
이번에는 Sample_hello_world에 하나의 매개변수만 전달할 수도 있고, 두 개의 완전한 매개변수를 전달할 수도 있습니다. 그렇다면 확장 기능에서 동일한 기능을 어떻게 구현할 수 있습니까? zend_parse_parameters에서 (|) 매개변수를 사용해야 합니다. 이 매개변수 이전의 매개변수는 필수로 간주되며, 전달되지 않은 매개변수는 필수가 아닌 것으로 간주됩니다.
ZEND_FUNCTION(sample_hello_world) {
char *name;
int name_len;
char *greeting = "Mr./Mrs."
int Greeting_len = sizeof("Mr./Mrs. ") -1;


if (zend_parse_parameters (zend_num_args () tsrmls_cc," s | s ",
& name_len, & Greeting_len) == 실패
Return_null ( );
}
php_printf("안녕하세요");
PHPWRITE(greeting, Greeting_len);
php_printf(" ")
PHPWRITE(이름, 이름_len); );
}
두 번째 매개변수를 전달하지 않으면 확장 기능이 기본값으로 간주되어 벡터를 수정하지 않습니다. 따라서 캐리어의 값은 NULL인 경우가 많거나 함수 로직과 관련된 값을 직접 미리 설정해야 합니다. IS_NULL 유형 zval을 포함한 각 zval은 일정한 양의 메모리 공간을 점유해야 하며 이에 대한 메모리를 적용하고 초기화하고 작업 완료 후 해제하려면 CPU 컴퓨팅 리소스가 필요합니다. 그러나 많은 코드가 이를 인식하지 못합니다. IS_NULL 유형의 zval에 null 값을 래핑하는 코드가 많이 있습니다. 이 작업은 확장 개발에서 최적화될 수 있습니다. C 언어에서는 매개변수를 NULL로 받을 수 있습니다. 이 문제에 대해 다음 코드를 살펴보겠습니다.
ZEND_FUNCTION(sample_arg_fullnull) {
zval *val;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z",&val) == FAILURE) {
RETURN_NULL();
}
if (Z_TYPE_P(val) == IS_NULL) {
val = php_sample_make_defaultval(TSRMLS_C)
}
...
}
ZEND_FUNCTION (sample_arg_nullok) {
zval *val;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z!",
                                        {
RETURN_NULL()
}
if (! val) {
val = php_sample_make_defaultval(TSRMLS_C)
}
}
두 코드 조각은 언뜻 보면 크게 다르지 않지만 첫 번째 코드 조각에는 더 많은 CPU와 메모리 리소스가 필요합니다. 어쩌면 이 기술은 평소에는 그다지 유용하지 않을 수도 있지만, 모르는 것보다는 아는 것이 더 낫습니다.

강제 분리
변수가 함수에 전달되면 참조 여부에 관계없이 refcoung__gc 속성이 1씩 증가하여 최소 2가 됩니다. 하나의 복사본은 그 자체이고 다른 하나는 함수에 전달된 복사본입니다. 이 zval을 변경하기 전에 미리 두 개의 실제 복사본으로 나누어야 하는 경우가 있습니다. "/" 형식 문자의 역할입니다. 쓰기 중 복사 zval을 미리 두 개의 완전하고 독립적인 복사본으로 분할하므로 다음 코드에서 마음대로 작업할 수 있습니다. 그렇지 않으면 수신된 매개변수와 기타 작업을 분리하도록 지속적으로 상기시켜야 할 수도 있습니다. NULL 플래그와 마찬가지로 이 수정자는 영향을 미치려는 유형을 따릅니다. 또한 NULL 플래그와 마찬가지로 이 기능을 실제로 사용할 때까지 이 기능이 필요한지 알 수 없습니다.

zend_get_arguments()
확장 프로그램이 이전 버전의 PHP와 호환되기를 원하거나 매개변수를 수신하기 위한 전달자로 zval을 사용하려는 경우 zend_get_parameters() 함수를 사용하여 매개변수를 수신하는 것을 고려할 수 있습니다. zend_get_parameters()는 zend_parse_parameters()와 다릅니다. 이름에서 알 수 있듯이 파싱 없이 직접 가져옵니다. 우선, 확장 구현에서 모든 매개변수의 전달자는 zval 유형이어야 합니다. 가장 간단한 예를 살펴보겠습니다.
ZEND_FUNCTION(sample_onearg) {
zval * firstarg ;
if (zend_get_parameters(ZEND_NUM_ARGS(), 1, &firstarg)== FAILURE) {
php_error_docref(NULL TSRMLS_CC, E_WARNING, "1개 이상의 매개변수가 필요합니다."); > }
/* firstarg로 뭔가를 하세요... */
}
두 번째로, zend_get_parameters()는 수신 실패 시 자체적으로 오류를 발생시키지 않으며 매개변수의 기본값을 편리하게 처리할 수도 없습니다. 마지막 요점은 쓰기 중 복사를 준수하는 모든 zval을 자동으로 강제로 분리하고 새 복사본을 생성하여 함수에 보낸다는 점에서 zend_parse_parameters와 다르다는 것입니다. 다른 기능을 사용하고 싶지만 이 함수가 필요하지 않은 경우 zend_get_parameters_ex() 함수를 사용하여 매개변수를 받을 수 있습니다. 쓰기 중 복사의 변수를 분리하지 않기 위해 zend_get_parameters_ex()의 매개변수는 zval* 대신 zval** 유형입니다. 이 함수는 극단적인 문제가 발생할 때만 생각할 수 있지만 사용하기는 매우 간단합니다.
ZEND_FUNCTION(sample_onearg) {
zval **firstarg; zend_get_parameters_ex(1, &firstarg) == FAILURE) {
WRONG_PARAM_COUNT;
}
/* firstarg로 작업 수행... */
}
zend_get_parameters_ex에는 ZEND_NUM_ARGS()가 필요하지 않습니다. 매개변수로서 이후 단계에서 추가되었으므로 해당 매개변수는 더 이상 필요하지 않습니다.
위 예제에서도 WRONG_PARAM_COUNT 매크로가 사용되었습니다. 그 기능은 E_WARNING 수준 오류 메시지를 발생시키고 자동으로 반환하는 것입니다.

변수 매개변수
두 가지 다른 zend_get_parameter_** 함수가 있는데, 이는 매개변수가 많거나 매개변수 개수를 미리 알 수 없는 문제를 해결하는 데 특별히 사용됩니다. PHP 언어에서 var_dump() 함수의 사용법을 생각해 보세요. 커널에서의 구현은 실제로 다음과 같습니다.
ZEND_FUNCTION(var_dump) {
int i, argc = ZEND_NUM_ARGS ();
zval ***args;

args = (zval ***)safe_emalloc(argc, sizeof(zval **), 0); == 0 || zend_get_parameters_array_ex(argc, args) == 실패) {
efree(args);
WRONG_PARAM_COUNT;
}
for (i=0; i php_var_dump(args[i], 1 TSRMLS_CC);
}
efree(args);
}
프로그램은 먼저 매개변수 수를 얻은 다음 해당 메모리 크기에 적용합니다. safe_emalloc 함수를 통해 이러한 zvals ** 유형 매개변수를 저장합니다. 여기서 zend_get_parameters_array_ex() 함수는 함수에 전달된 매개변수를 args에 채우는 데 사용됩니다. zend_get_parameters_array()라는 함수도 있다는 것을 즉시 생각하셨을 것입니다. 유일한 차이점은 zval* 유형 매개변수를 args에 채우고 매개변수로 ZEND_NUM_ARGS()가 필요하다는 것입니다.

본 웹사이트의 성명
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.

핫 AI 도구

Undresser.AI Undress

Undresser.AI Undress

사실적인 누드 사진을 만들기 위한 AI 기반 앱

AI Clothes Remover

AI Clothes Remover

사진에서 옷을 제거하는 온라인 AI 도구입니다.

Undress AI Tool

Undress AI Tool

무료로 이미지를 벗다

Clothoff.io

Clothoff.io

AI 옷 제거제

Video Face Swap

Video Face Swap

완전히 무료인 AI 얼굴 교환 도구를 사용하여 모든 비디오의 얼굴을 쉽게 바꾸세요!

뜨거운 도구

메모장++7.3.1

메모장++7.3.1

사용하기 쉬운 무료 코드 편집기

SublimeText3 중국어 버전

SublimeText3 중국어 버전

중국어 버전, 사용하기 매우 쉽습니다.

스튜디오 13.0.1 보내기

스튜디오 13.0.1 보내기

강력한 PHP 통합 개발 환경

드림위버 CS6

드림위버 CS6

시각적 웹 개발 도구

SublimeText3 Mac 버전

SublimeText3 Mac 버전

신 수준의 코드 편집 소프트웨어(SublimeText3)

Ubuntu 및 Debian용 PHP 8.4 설치 및 업그레이드 가이드 Ubuntu 및 Debian용 PHP 8.4 설치 및 업그레이드 가이드 Dec 24, 2024 pm 04:42 PM

PHP 8.4는 상당한 양의 기능 중단 및 제거를 통해 몇 가지 새로운 기능, 보안 개선 및 성능 개선을 제공합니다. 이 가이드에서는 Ubuntu, Debian 또는 해당 파생 제품에서 PHP 8.4를 설치하거나 PHP 8.4로 업그레이드하는 방법을 설명합니다.

이전에 몰랐던 후회되는 PHP 함수 7가지 이전에 몰랐던 후회되는 PHP 함수 7가지 Nov 13, 2024 am 09:42 AM

숙련된 PHP 개발자라면 이미 그런 일을 해왔다는 느낌을 받을 것입니다. 귀하는 상당한 수의 애플리케이션을 개발하고, 수백만 줄의 코드를 디버깅하고, 여러 스크립트를 수정하여 작업을 수행했습니다.

PHP 개발을 위해 Visual Studio Code(VS Code)를 설정하는 방법 PHP 개발을 위해 Visual Studio Code(VS Code)를 설정하는 방법 Dec 20, 2024 am 11:31 AM

VS Code라고도 알려진 Visual Studio Code는 모든 주요 운영 체제에서 사용할 수 있는 무료 소스 코드 편집기 또는 통합 개발 환경(IDE)입니다. 다양한 프로그래밍 언어에 대한 대규모 확장 모음을 통해 VS Code는

JWT (JSON Web Tokens) 및 PHP API의 사용 사례를 설명하십시오. 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에서 HTML/XML을 어떻게 구문 분석하고 처리합니까? PHP에서 HTML/XML을 어떻게 구문 분석하고 처리합니까? Feb 07, 2025 am 11:57 AM

이 튜토리얼은 PHP를 사용하여 XML 문서를 효율적으로 처리하는 방법을 보여줍니다. XML (Extensible Markup Language)은 인간의 가독성과 기계 구문 분석을 위해 설계된 다목적 텍스트 기반 마크 업 언어입니다. 일반적으로 데이터 저장 AN에 사용됩니다

문자열로 모음을 계산하는 PHP 프로그램 문자열로 모음을 계산하는 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에서 늦은 정적 결합을 설명하십시오 (정적 : :). PHP에서 늦은 정적 결합을 설명하십시오 (정적 : :). Apr 03, 2025 am 12:04 AM

정적 바인딩 (정적 : :)는 PHP에서 늦은 정적 바인딩 (LSB)을 구현하여 클래스를 정의하는 대신 정적 컨텍스트에서 호출 클래스를 참조 할 수 있습니다. 1) 구문 분석 프로세스는 런타임에 수행됩니다. 2) 상속 관계에서 통화 클래스를 찾아보십시오. 3) 성능 오버 헤드를 가져올 수 있습니다.

php magic 방법 (__construct, __destruct, __call, __get, __set 등)이란 무엇이며 사용 사례를 제공합니까? 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