xml_parser_set_optionУстановка значения настройки XML-анализатора
&reftitle.description;
boolxml_parser_set_optionXMLParserparserintoptionstringintboolvalue
Устанавливает значение настройки XML-анализатора.
&reftitle.parameters;
parser
Ссылка на XML-анализатор.
option
Какую настройку требуется установить. Смотрите ниже.
Доступны следующие настройки:
Настройки XML-анализатораКонстантаТип данныхОписаниеXML_OPTION_CASE_FOLDINGbool
Требуется ли включить case-folding для этого
анализатора. Включено по умолчанию.
XML_OPTION_PARSE_HUGEbool
Позволяет разбирать документы размером более 10 МБ.
Настройка должна быть включена только в том случае, если размер документа ограничен,
поскольку в противном случае это может привести к DoS.
Настройка доступна только при использовании libxml2.
XML_OPTION_SKIP_TAGSTARTinteger
Задаёт количество символов с начала имени тега, которые следует
пропустить.
XML_OPTION_SKIP_WHITEbool
Требуется ли пропускать значения, состоящие из пробелов.
XML_OPTION_TARGET_ENCODINGstring
Устанавливает кодировку,
которая будет использоваться XML анализатором. По умолчанию
используется кодировка заданная при вызове функции
xml_parser_create. Поддерживаются кодировки
ISO-8859-1, US-ASCII и
UTF-8.
value
Новое значение настройки.
&reftitle.returnvalues;
Возвращает &true; в случае успешного выполнения или &false; в случае возникновения ошибки.
&reftitle.errors;
Если в параметр option передано недопустимое значение,
выбрасывается исключение ValueError.
До PHP 8.0.0 функция возвращала значение false,
когда отправка в параметр option недопустимого значения
приводила к ошибке уровня E_WARNING,
что и заставляло функцию возвращать логическое значение &false;.
&reftitle.changelog;
&Version;&Description;8.4.0
Добавлена настройка XML_OPTION_PARSE_HUGE.
8.3.0
Теперь параметр value также принимает логические значения.
Настройки XML_OPTION_CASE_FOLDING и XML_OPTION_SKIP_WHITE
теперь логические.
&xml.changelog.parser-param;
8.0.0
Теперь выбрасывается исключение ValueError,
если значение параметра option недопустимо.