SimpleXMLElement::__construct

(PHP 5, PHP 7)

SimpleXMLElement::__construct Crea un nuevo objeto SimpleXMLElement

Descripción

final public SimpleXMLElement::__construct ( string $data [, int $options = 0 [, bool $data_is_url = FALSE [, string $ns = "" [, bool $is_prefix = 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ón Descripción
5.2.0 Añadidos los parámetros ns y is_prefix.
5.1.2 Añ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'NULLTRUE);
echo 
$sxe->asXML();

?>

Ver también