XML Parser xml_set_start_namespace_decl_handler
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
xml_set_start_namespace_decl_handler — 시작 네임스페이스 선언 핸들러 설정
설명
xml_set_start_namespace_decl_handler(XMLParser $parser
, callable $handler
): bool
네임스페이스가 선언될 때 호출될 핸들러를 설정합니다. 네임스페이스 선언은 시작 태그 내에서 발생합니다. 그러나 네임스페이스 선언 시작 핸들러는 해당 시작 태그에 선언된 각 네임스페이스에 대한 시작 태그 핸들러보다 먼저 호출됩니다.
매개변수
parser
- XML 파서에 대한 참조입니다.
handler
handler
는parser
를 위해 xml_parse()가 호출될 때 존재해야 하는 함수의 이름을 포함하는 문자열입니다.handler
에 의해 명명된 함수는 세 개의 매개변수를 허용해야 하며 정수 값을 리턴해야 합니다. 핸들러에서 반환된 값이false
(값이 반환되지 않은 경우)이면 XML 파서는 구문 분석을 중지하고 xml_get_error_code()는XML_ERROR_EXTERNAL_ENTITY_HANDLING
을 반환합니다.handler(XMLParser
$parser
, string$prefix
, string$uri
)parser
- 첫 번째 매개변수인 parser는 핸들러를 호출하는 XML 파서에 대한 참조입니다.
prefix
- 접두사는 XML 개체 내에서 네임스페이스를 참조하는 데 사용되는 문자열입니다.
uri
- 네임스페이스의 URI(Uniform Resource Identifier)입니다.
핸들러 함수가 빈 문자열 또는
false
로 설정되면 해당 핸들러가 비활성화됩니다.참고: 함수 이름 대신 객체 참조와 메서드 이름이 포함된 배열을 제공할 수도 있습니다.
반환 값
성공하면 true
를, 실패하면 false
를 반환합니다.
변경 로그
버전 | 설명 |
---|---|
8.0.0 | parser 는 이제 XMLParser 인스턴스를 예상합니다. 이전에는 리소스가 필요했습니다. |
기타
- xml_set_end_namespace_decl_handler() - 최종 네임스페이스 선언 핸들러 설정