simplexml_load_file

(PHP 5, PHP 7, PHP 8)

simplexml_load_fileConvierte un fichero XML en objeto

Descripción

simplexml_load_file(
    string $filename,
    ?string $class_name = SimpleXMLElement::class,
    int $options = 0,
    string $namespace_or_prefix = "",
    bool $is_prefix = false
): SimpleXMLElement|false

Convierte el documento XML filename en un objeto de tipo SimpleXMLElement.

Parámetros

filename

Ruta hacia el fichero XML

class_name

Puede utilizarse este parámetro opcional, y así, la función simplexml_load_file() devolverá un objeto de la clase especificada. Esta clase debe extender la clase SimpleXMLElement.

options

Bitwise OR of the libxml option constants.

namespace_or_prefix

Prefijo o la URI del espacio de nombres.

is_prefix

true si namespace_or_prefix es un prefijo, false si es la URI; por omisión, false.

Valores devueltos

Devuelve un objet de la clase SimpleXMLElement cuyas propiedades contienen los datos del documento XML, o false en caso de error.

Advertencia

Esta función puede devolver el valor booleano false, pero también puede devolver un valor no booleano que se evalúa como false. Por favor lea la sección sobre Booleanos para más información. Use el operador === para comprobar el valor devuelto por esta función.

Errores/Excepciones

Genera un mensaje de error de nivel E_WARNING para cada error encontrado en los datos XML.

Sugerencia

Utilice la función libxml_use_internal_errors() para suprimir todos los errores XML, y la función libxml_get_errors() para recorrerlos.

Ejemplos

Ejemplo #1 Interpretación de un documento XML

<?php
// El fichero examples/book.xml contiene un documento XML con un elemento raíz
// y al menos un elemento /[raíz]/title.

if (file_exists('examples/book.xml')) {
$xml = simplexml_load_file('examples/book.xml');

print_r($xml);
} else {
exit(
'Fallo al abrir el fichero examples/test.xml.');
}
?>

Este script mostrará, en caso de éxito:

SimpleXMLElement Object
(
  [book] => Array
  ...
)

A partir de ahí, puede utilizarse $xml->title y cualquier otro elemento.

Ver también