array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.xml-parser-set-option.php', 1 => 'xml_parser_set_option', 2 => 'Установка значения настройки XML-анализатора', ), 'up' => array ( 0 => 'ref.xml.php', 1 => 'Функции парсера XML', ), 'prev' => array ( 0 => 'function.xml-parser-get-option.php', 1 => 'xml_parser_get_option', ), 'next' => array ( 0 => 'function.xml-set-character-data-handler.php', 1 => 'xml_set_character_data_handler', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/xml/functions/xml-parser-set-option.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

xml_parser_set_option

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

xml_parser_set_option — Установка значения настройки XML-анализатора

Описание

xml_parser_set_option(XMLParser $parser, int $option, string|int|bool $value): bool

Устанавливает значение настройки XML-анализатора.

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

parser

Ссылка на XML-анализатор.

option

Какую настройку требуется установить. Смотрите ниже.

Доступны следующие настройки:
Настройки XML-анализатора
Константа Тип данных Описание
XML_OPTION_CASE_FOLDING bool Требуется ли включить case-folding для этого анализатора. Включено по умолчанию.
XML_OPTION_PARSE_HUGE bool Позволяет разбирать документы размером более 10 МБ. Настройка должна быть включена только в том случае, если размер документа ограничен, поскольку в противном случае это может привести к DoS. Настройка доступна только при использовании libxml2.
XML_OPTION_SKIP_TAGSTART integer Задаёт количество символов с начала имени тега, которые следует пропустить.
XML_OPTION_SKIP_WHITE bool Требуется ли пропускать значения, состоящие из пробелов.
XML_OPTION_TARGET_ENCODING string Устанавливает кодировку, которая будет использоваться XML анализатором. По умолчанию используется кодировка заданная при вызове функции xml_parser_create(). Поддерживаются кодировки ISO-8859-1, US-ASCII и UTF-8.

value

Новое значение настройки.

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

Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.

Ошибки

Если в параметр option передано недопустимое значение, выбрасывается исключение ValueError.

До PHP 8.0.0 функция возвращала значение false, когда отправка в параметр option недопустимого значения приводила к ошибке уровня E_WARNING, что и заставляло функцию возвращать логическое значение false.

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

Версия Описание
8.4.0 Добавлена настройка XML_OPTION_PARSE_HUGE.
8.3.0 Теперь параметр value также принимает логические значения. Настройки XML_OPTION_CASE_FOLDING и XML_OPTION_SKIP_WHITE теперь логические.
8.0.0 Параметр parser ожидает экземпляр класса XMLParser; раньше параметр ждал корректный xml-ресурс (resource).
8.0.0 Теперь выбрасывается исключение ValueError, если значение параметра option недопустимо.