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

Operación de 'OR' lógica de las constantes de opción libxml.

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 objeto de la clase SimpleXMLElement cuyas propiedades contienen los datos del documento XML, o false si ocurre un error.

Advertencia

Esta función puede retornar false, pero también puede retornar un valor equivalente a false. Por favor, lea la sección sobre los booleanos para más información. Utilice el operador === para probar el valor de retorno exacto de 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