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_FOLDINGboolЧи потрібно включити case-folding для цього аналізатора. Увімкнено за замовчуванням.
XML_OPTION_SKIP_TAGSTARTintegerЗадає кількість символів з початку імені тега, які потрібно пропустити.
XML_OPTION_SKIP_WHITEboolЧи потрібно пропускати значення, що складаються з прогалин.
XML_OPTION_TARGET_ENCODINGstringУстанавливаеткодування, яка буде використовуватися аналізатором XML. За замовчуванням використовується кодування, задане при виклику функції xml_parser_create(). . Підтримуються кодування ISO-8859-1US-ASCIIиUTF-8

value

Нове значення налаштування.

Значення, що повертаються

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

Помилки

Якщо параметр option передано неприпустиме значення, викидається виняток ValueError

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

список змін

ВерсияОпис
8.3.0Тепер параметр value також набуває логічних значень. Налаштування XML_OPTION_CASE_FOLDING і XML_OPTION_SKIP_WHITE тепер логічні.
8.0.0Параметрparser чекає на екземпляр XMLParser; раніше очікувався коректний xml ресурс (Resource).
8.0.0Тепер викидається винятокValueError, если значение параметраoptionнедопустимо.