(PHP 4, PHP 5, PHP 7, PHP 8)
xml_parser_set_option — Set options in an XML parser
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.
|