(PHP 4, PHP 5, PHP 7, PHP 8)

xml_set_default_handlerУстановка обработчика по умолчанию


xml_set_default_handler(XMLParser $parser, callable $handler): true

Задаёт обработчик по умолчанию для XML-анализатора parser.

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


Парсер XML.


Если передаётся значение null или пустая строка, то обработчик возвращается в состояние по умолчанию.

Если параметр handler является типом callable, то в качестве обработчика устанавливается callable.

Если параметр handler является строкой (string), то это может быть имя метода объекта, заданного с помощью функции xml_set_object().

Сигнатура обработчика должна быть:

handler(XmlParser $parser, string $data): void
XML-парсер, вызывающий обработчик.
Параметр data содержит данные в виде текстовой строки. Это может быть объявление XML, объявление типа документа, сущности или другие данные, для которых не существует другого обработчика.

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

Функция всегда возвращает true.

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

Версия Описание
8.0.0 Параметр parser ожидает экземпляр класса XMLParser; раньше параметр ждал корректный xml-ресурс (resource).
add a note

User Contributed Notes 3 notes

jp dot amarok at email dot cz
1 month ago
For anyone who was also wondering what kind of events this function actually handles:

it's used in cases when an XML comment is found or an additional declaration like an xml-stylesheet. In such cases the data argument contains the whole string as it is, for example:

<!-- this is a comment -->
<?xml-stylesheet title="mystyle" type="text/xsl" href="style.xsl" ?>
19 years ago
it seems to me that in PHP5 the function defined as default-handler (using xml_set_default_handler()) doesen't get passed the cdata anymore:

xml_set_element_handler($this->parser, 'parseSTART', 'parseEND');
xml_set_default_handler($this->parser, 'parseDEFAULT');
function parseSTART() { ... }
function parseEND() { ... }
function parseDEFAULT() { ... }

under PHP5, parseDEFAULT will NOT get passed any cdata, but unter PHP4 it will. at least that's my take on the strange stuff (not) happening after migrating to PHP5.

my solution was to add a xml_set_character_data_handler($parser, 'parseDEFAULT'). it worked for me.
anoril at anoril dot com
17 years ago
I have the same issue using two installation of PHP5: on accepts to use the default handler while the other only uses the character_data one.

Maybe a configuration problem...

;) Nonor.
To Top