PHP Manual
Функции парсера XML
Установка обработчика входа в пределы пространства имен

xml_set_start_namespace_decl_handler

(PHP 4 >= 4.0.5, PHP 5, PHP 7)

xml_set_start_namespace_decl_handler — Установка обработчика входа в пределы пространства имен

Описание

xml_set_start_namespace_decl_handler ( XMLParser $parser , callable $handler ) : bool

Задает обработчик события входа в пространство имен. То есть обработчик вызывается анализатор находит объявление пространства имен. Подобные объявления находятся в открывающих тэгах элементов. Этот обработчик вызывается до обработчика начала тэга.

Список параметров

parser

Ссылка на XML-анализатор.

handler

handler - строка содержащая имя функции, которая должна быть определена на момент вызова функции xml_parse() из анализатора parser.

Функция с именем 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) пространства имен.

Если в качестве обработчика передана пустая строка или false, этот обработчик отключается.

Замечание: В качестве аргумента вместо имени функции может быть передан массив, содержащий ссылку на объект и имя метода.

Возвращаемые значения

Возвращает true в случае успешного завершения или false в случае возникновения ошибки.

Список изменений

Версия	Описание
8.0.0	Параметр `parser` ожидает экземпляр XMLParser; ранее ожидался ресурс (resource).

Смотрите также

xml_set_end_namespace_decl_handler() - Установка обработчика выхода за пределы пространства имен