array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.xml-parser-set-option.php', 1 => 'xml_parser_set_option', 2 => 'Define opções em um analisador XML', ), 'up' => array ( 0 => 'ref.xml.php', 1 => 'Funções para analisar 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' => 'pt_BR', '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 — Define opções em um analisador XML

Descrição

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

Define uma opção em uma analisador XML.

Parâmetros

parser

Uma referência ao analisador XML ao qual se deseja definir uma opção.

option

Qual a opção a definir. Veja abaixo.

As opções a seguir estão disponíveis:
Opções do analisador XML
Constante da opção Tipo de dados Descrição
XML_OPTION_CASE_FOLDING bool Controla se case-folding está habilitado para este analisador XML. Ativado por padrão.
XML_OPTION_PARSE_HUGE bool Permite analisar documentos maiores que 10 MB. Esta opção só deve ser habilitada quando o tamanho do documento for limitado, pois isso poderia levar a um DoS. Esta opção só está disponível ao usar libxml2.
XML_OPTION_SKIP_TAGSTART integer Especifica quantos caracteres devem ser ignorados no início do nome de uma etiqueta.
XML_OPTION_SKIP_WHITE bool Controla se deve-se ignorar valores constituídos por espaços em branco.
XML_OPTION_TARGET_ENCODING string Define qual codificação de destino será usada neste analisador XML. Por pradrão, é definida com a mesma codificação usada por xml_parser_create(). Codificações de destino suportadas são ISO-8859-1, US-ASCII e UTF-8.

value

O novo valor da opção.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

Lança uma exceção ValueError quando um valor inválido é passado em option.

Antes do PHP 8.0.0, passar um valor inválido em option gerava um erro de nível E_WARNING e também fazia a função retornar false.

Registro de Alterações

Versão Descrição
8.4.0 Adicionada a opção XML_OPTION_PARSE_HUGE.
8.3.0 O parâmetro value agora aceita booleanos. As opções XML_OPTION_CASE_FOLDING e XML_OPTION_SKIP_WHITE são agora opções booleanas.
8.0.0 O parâmetro parser agora espera uma instância de XMLParser; anteriormente, um resource xml válido era esperado.
8.0.0 Uma exceção ValueError agora é lançada se option for inválido.