xml_parser_set_option

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

xml_parser_set_optionEstablece las opciones de un analizador XML

Descripción

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

Establece las opciones de un analizador XML.

Parámetros

parser

Una referencia a un analizador XML.

option

La opción a modificar. Ver más abajo.

Las siguientes opciones están disponibles:

Opciones del analizador XML
Opción Tipo de datos Descripción
XML_OPTION_CASE_FOLDING bool Controla el manejo de la caja de las etiquetas de este analizador XML. Por omisión, está activado.
XML_OPTION_PARSE_HUGE bool Permite analizar documentos de más de 10 MB. Esta opción solo debe activarse si el tamaño del documento está limitado, ya que de lo contrario podría conducir a un ataque de denegación de servicio (DoS). Esta opción solo está disponible al usar libxml2.
XML_OPTION_SKIP_TAGSTART bool Especifica cuántos caracteres deben omitirse al inicio del nombre de la etiqueta.
XML_OPTION_SKIP_WHITE entero Omite o no los valores que contienen caracteres en blanco.
XML_OPTION_TARGET_ENCODING string Modifica la codificación de destino utilizada por este analizador XML. Por omisión, es la que se especificó al llamar a xml_parser_create(). Las codificaciones soportadas son ISO-8859-1, US-ASCII y UTF-8.

value

El nuevo valor de la opción.

Valores devueltos

Devuelve true en caso de éxito o false en caso de fallo.

Errores/Excepciones

Lanza una ValueError cuando se pasa un valor inválido a option.

Antes de PHP 8.0.0, pasar un valor inválido a option generaba una advertencia E_WARNING y hacía que la función devolviera el valor false.

Historial de cambios

Versión Descripción
8.4.0 Se añadió la opción XML_OPTION_PARSE_HUGE.
8.3.0 El parámetro value ahora también acepta valores booleanos. Las opciones XML_OPTION_CASE_FOLDING y XML_OPTION_SKIP_WHITE ahora son opciones booleanas.
8.0.0 parser ahora espera una instancia de XMLParser en lugar de un resource xml.
8.0.0 Ahora se lanza una excepción ValueError si la option es inválida.