xml_set_external_entity_ref_handler - Установка обработчика внешних сущностей
Вернуться к: Функции парсера XML
xml_set_external_entity_ref_handler
(PHP 4, PHP 5, PHP 7)
xml_set_external_entity_ref_handler — Установка обработчика внешних сущностей
Описание
Задает функцию обработчик внешних сущностей для XML анализатора
parser
.
Список параметров
-
parser
-
Ссылка на XML анализатор.
-
handler
-
handler
- строка содержащая имя функции, которая должна быть определена на момент вызова функции xml_parse() из анализатораparser
.Функция с именем
handler
должна принимать пять аргументов и возвращать целочисленный результат. Если обработчик вернетFALSE
(равно как и ничего не вернет), XML анализатор прекратит работу, а функция xml_get_error_code() будет возвращать константуXML_ERROR_EXTERNAL_ENTITY_HANDLING
.handler ( resource$parser
, string$open_entity_names
, string$base
, string$system_id
, string$public_id
)-
parser
- Первый аргумент parser является ссылкой на XML анализатор вызывающий обработчик.
-
open_entity_names
-
Второй аргумент
open_entity_names
- список разделенных пробелами имен сущностей, которые могут участвовать в разборе текущей сущности (включая текущую сущность). -
base
-
Это основа для разрешения системного идентификатора
(
system_id
) внешней сущности. На данный момент в качестве этого аргумента всегда передается пустая строка. -
system_id
-
Четвертый аргумент
system_id
- системный идентификатор в том виде, как он представлен в объявлении сущности. -
public_id
-
Пятый аргумент
public_id
- общедоступный идентификатор в том виде, как он представлен в объявлении сущности, либо пустая строка, если такового нет; пробелы в идентификаторе будут нормализованы в соответствии с требованиями XML спецификации.
Если в качестве обработчика передана пустая строка или
FALSE
, этот обработчик отключается.Замечание: В качестве аргумента вместо имени функции может быть передан массив, содержащий ссылку на объект и имя метода.
-
Возвращаемые значения
Возвращает TRUE
в случае успешного завершения или FALSE
в случае возникновения ошибки.
Вернуться к: Функции парсера XML