(PHP 4, PHP 5, PHP 7, PHP 8)
xml_parser_set_option — Set options in an XML parser
xml_parser_set_option(XMLParser $parser, int $option, string|int|bool $value): bool
Sets an option in an XML parser.
parserA reference to the XML parser to set an option in.
optionWhich option to set. See below.
The following options are available:
| Option constant | Data type | Description |
|---|---|---|
XML_OPTION_CASE_FOLDING | bool | Controls whether case-folding is enabled for this XML parser. Enabled by default. |
XML_OPTION_PARSE_HUGE | bool | Allows parsing documents larger than 10 MB. This option should only be enabled when the document size is bounded because this could otherwise lead to a DoS. This option is only available when using libxml2. |
XML_OPTION_SKIP_TAGSTART | integer | Specify how many characters should be skipped in the beginning of a tag name. |
XML_OPTION_SKIP_WHITE | bool | Whether to skip values consisting of whitespace characters. |
XML_OPTION_TARGET_ENCODING | string | Sets which target encoding to use in this XML parser.By default, it is set to the same as the source encoding used by xml_parser_create(). Supported target encodings are ISO-8859-1, US-ASCII and UTF-8. |
valueThe option's new value.
Throws a ValueError when an invalid value is passed to option.
Prior to PHP 8.0.0, the function returned false when passing an invalid value to option generated a E_WARNING as well as making the function return false.
| Version | Description |
|---|---|
| 8.4.0 | Added the option XML_OPTION_PARSE_HUGE. |
| 8.3.0 | The value parameter now also accepts booleans. The options XML_OPTION_CASE_FOLDING and XML_OPTION_SKIP_WHITE are now boolean options. |
| 8.0.0 | parser expects an XMLParser instance now; previously, a valid xml resource was expected. |
| 8.0.0 | A ValueError is now thrown if option is invalid. |
© 1997–2025 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.xml-parser-set-option.php