(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.
parserUna referencia a un analizador XML.
optionLa 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 |
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.
|
valueEl 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 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.
|