array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.xml-parser-set-option.php', 1 => 'xml_parser_set_option', 2 => '在 XML 解析器中设置选项', ), 'up' => array ( 0 => 'ref.xml.php', 1 => 'XML 解析器函数', ), 'prev' => array ( 0 => 'function.xml-parser-get-option.php', 1 => 'xml_parser_get_option', ), 'next' => array ( 0 => 'function.xml-set-character-data-handler.php', 1 => 'xml_set_character_data_handler', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/xml/functions/xml-parser-set-option.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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_FOLDING bool 控制是否为此 XML 解析器启用大写转换。默认启用。
XML_OPTION_PARSE_HUGE bool 允许解析大于 10 MB 的文档。 仅当文档大小有限时才应启用此选项，否则可能导致 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 之前，向 option 传递的值无效时会生成 E_WARNING 并使函数返回 false。

更新日志

版本 说明
8.4.0 添加了选项 XML_OPTION_PARSE_HUGE。
8.3.0 value 参数现在也接受 bool。选项 XML_OPTION_CASE_FOLDING 和 XML_OPTION_SKIP_WHITE 现在是 bool 选项。
8.0.0 parser 现在接受 XMLParser 实例；之前接受有效的 xml resource。
8.0.0 如果 option 无效，现在抛出 ValueError。