xml_set_external_entity_ref_handler
xml_set_external_entity_ref_handler
(PHP 3>= 3.0.6, PHP 4)
xml_set_external_entity_ref_handler - настраивает внешний обработчик экземпляров.
Описание
bool xml_set_external_entity_ref_handler (resource parser, string handler)
Устанавливает функцию внешнего обработчика экземпляров для XML-разборщика parser.
handler это строка с именем функции, которая обязана существовать в момент вызова
xml_parse() для parser.
Функция handler обязана принимать 5 параметров и возвращать integer-значение. Если возвращается FALSE (если никакого значения не возвращено), XML-разборщик остановит разбор, а xml_get_error_code() возвратит return XML_ERROR_EXTERNAL_ENTITY_HANDLING.
handler (resource parser, string open_entity_names, string base, string system_id, string public_id)
- parser
Это ссылка на XML-разборщик, вызывающий обработчик.
- open_entity_names
Это список разделённых пробелами имён мнемоник, открытых для разбора этого экземпляра (включая имя экземпляра).
- base
Это база для разрешения системного идентификатора (system_id) внешнего экземпляра/entity. В настоящее время в этот параметр всегда устанавливается пустая строка.
- system_id
Это системный идентификатор, как специфицировано в объявлении экземпляра.
- public_id
Это public-идентификатор, как специфицировано в объявлении экземпляра, или пустая строка, если ничего не было специфицировано; пробелы в public-идентификаторе будут нормализованы, как требует XML spec.
Если функция обработчика установлена как пустая строка, или FALSE, обработчик отключается/disabled.
TRUE возвращается, если обработчик настроен, а FALSE, если parser не является разборщиком.
Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.