Home/ Manual/ xml / functions/ xml_parser_set_option

xml_parser_set_option

PHP function Edit on GitHub ✎

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

Set options in an XML parser

Description

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

Sets an option in an XML parser.

parser

A reference to the XML parser to set an option in.

option

Which 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`.

value

The option's new value.

Returns true on success or false on failure.

Throws a ValueError when an invalid value is passed to option.

Prior to PHP 8.0.0, passing an invalid value to option generated an E_WARNING and made 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	A `ValueError` is now thrown if `option` is invalid.

Source: reference/xml/functions/xml-parser-set-option.xml · from the official PHP manual (php/doc-en)