(PHP 4, PHP 5, PHP 7, PHP 8)
xml_parser_set_option — Установка значения настройки XML-анализатора
Устанавливает значение настройки XML-анализатора.
parserСсылка на XML-анализатор.
optionКакую настройку требуется установить. Смотрите ниже.
Доступны следующие настройки:
| Константа | Тип данных | Описание |
|---|---|---|
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 недопустимо.
|