xml_set_external_entity_ref_handler
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
xml_set_external_entity_ref_handler
Референца за `function.xml-set-external-entity-ref-handler.php` со подобрена типографија и навигација.
xml_set_external_entity_ref_handler
(PHP 4, PHP 5, PHP 7, PHP 8)
xml_set_external_entity_ref_handler — Постави рачка за референци на надворешни ентитети
= NULL
Ја поставува функцијата за рачка за референци на надворешни ентитети за XML парсерот
parser.
Параметри
parser-
XML парсерот.
handler-
Враќа
nullсе поминува, рачката се ресетира на својата стандардна состојба.Ги ескејпува специјалните знаци во стринг за употреба во SQL изјаваПразен стринг исто така ќе ја ресетира рачката, меѓутоа ова е застарено од PHP 8.4.0.
Враќа
handlerе callable, повикливиот се поставува како рачка.Враќа
handlerе string, тоа може да биде името на метод на објект поставен со xml_set_object().Ги ескејпува специјалните знаци во стринг за употреба во SQL изјаваОва е застарено од PHP 8.4.0.
Ги ескејпува специјалните знаци во стринг за употреба во SQL изјаваОд PHP 8.4.0, повикливиот се проверува да биде валиден при поставување на рачката, а не кога се повикува. Ова значи дека xml_set_object() мора да се повика пред поставување на стринг за метод како повратен повик. Меѓутоа, бидејќи ова однесување е исто така застарено од PHP 8.4.0, користењето на соодветен callable за методот се препорачува наместо тоа.
Сигнатурата на рачката мора да биде:
handler(
XMLParser$parser,
string$open_entity_names,
string|false$base,
string$system_id,
string|false$public_id
): boolparser- XML парсерот што ја повикува рачката.
open_entity_names- Список со имиња на ентитети, разделени со празно место, кои се отворени за парсирање на овој ентитет (вклучувајќи го и името на реферираниот ентитет).
base-
Ова е основата за решавање на системскиот идентификатор (
system_id) на надворешниот ентитет. system_id- Системскиот идентификатор како што е специфициран во декларацијата на ентитетот.
public_id- Јавниот идентификатор како што е специфициран во декларацијата на ентитетот, или празен стринг ако не е специфициран; празнините во јавниот идентификатор ќе бидат нормализирани како што се бара со XML спецификацијата.
Рачката треба да врати
trueако ентитетот беше обработен,falseво спротивно. При враќањеfalseXML парсерот ќе престане со парсирање и xml_get_error_code() ќе вратиXML_ERROR_EXTERNAL_ENTITY_HANDLING.
Вратени вредности
Секогаш враќа true.
Дневник на промени
| Верзија | = NULL |
|---|---|
| 8.4.0 |
Поминување на не-callable string to
handler е сега застарено, користете соодветен повик за методи, или null за ресетирање на ракувачот.
|
| 8.4.0 |
Валидноста на handler како callable
се проверува сега при поставување на ракувачот наместо при негово повикување.
|
| 8.0.0 |
parser очекува XMLParser
инстанца сега; претходно, валидна xml resource се очекуваше.
|
| 7.3.0 |
Вратената вредност на handler веќе не се игнорира ако екстензијата е изградена против libxml. Претходно, вратената вредност се игнорираше, а парсирањето никогаш не престануваше.
|