SimpleXMLElement::__construct

(PHP 5, PHP 7, PHP 8)

SimpleXMLElement::__construct Crea un nuevo objeto SimpleXMLElement

Descripción

publicSimpleXMLElement::__construct(
    string$data,
    int$options = 0,
    bool$dataIsURL = false,
    string$namespaceOrPrefix = "",
    bool$isPrefix = false
)

Crea un nuevo objeto SimpleXMLElement.

Parámetros

data

Un string XML correcto o la ruta o URL a un documento XML si data_is_url es true.

options

Se utiliza opcionalmente para especificar parámetros adicionales de Libxml, que afectan a la lectura de los documentos XML. Las opciones que afectan a la salida de los documentos XML (p.e. LIBXML_NOEMPTYTAG) son silenciosamente ignoradas.

Nota:

Puede ser necesario pasar LIBXML_PARSEHUGE para poder procesar XML profundamente anidados o nodos de texto muy grandes.

data_is_url

Por defecto, data_is_url es false. Usar true para precisar que data es una ruta o URL a un documento XML en vez de un string de datos.

ns

Prefijo de espacio de nombres o URI.

is_prefix

true si ns es un prefijo, false si es una URI; por omisión, false.

Valores devueltos

Retorna un objeto SimpleXMLElement representando data.

Errores/Excepciones

Produce un mensaje de error E_WARNING por cada error encontrado en los datos XML y adicionalmente lanza una Exception si no se han podido analizar correctamente los datos XML.

Sugerencia

Debe usarse libxml_use_internal_errors() para eliminar todos los errores XML y libxml_get_errors() para iterar sobre ellos después.

Historial de cambios

VersiónDescripción
5.2.0Añadidos los parámetros ns y is_prefix.
5.1.2Añadidos los parámetros options y data_is_url.

Ejemplos

Nota:

Los ejemplos listados quizá incluyen example.php, que hacen referencia a la cadena XML encontrada en el primer ejemplo de la guía de uso básico.

Ejemplo #1 Crea un objeto SimpleXMLElement

<?php

include 'example.php';

$sxe = new SimpleXMLElement($xmlstr);
echo
$sxe->pelicula[0]->titulo;

?>

El resultado del ejemplo sería:

PHP: Tras el Parser

Ejemplo #2 Crea un objeto SimpleXMLElement a partir de una URL

<?php

$sxe
= new SimpleXMLElement('http://example.org/document.xml', NULL, TRUE);
echo
$sxe->asXML();

?>

Ver también

To Top