(PHP 4, PHP 5, PHP 7, PHP 8)
xml_parser_set_option — Establece las opciones de un analizador XML
Establece las opciones de un analizador XML.
parser
Una referencia a un analizador XML.
option
La opción a modificar. Ver más abajo.
Las siguientes opciones están disponibles:
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 |
entier | 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.
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
.
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 expects an XMLParser
instance now; previously, a valid xml resource was expected.
|
8.0.0 |
Ahora se lanza una excepción ValueError si
la option es inválida.
|