Interpreta un fichero XML en un objeto

# simplexml_load_file

(PHP 5, PHP 7, PHP 8)

simplexml_load_file — Interpreta un fichero XML en un objeto

### Descripción

function 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 object 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

- simplexml_load_string() - Interpreta un string XML en un objeto
- SimpleXMLElement::__construct() - Crea un nuevo objeto SimpleXMLElement
- Manejo de errores XML
- libxml_use_internal_errors() - Se desactiva el reporte de errores de libxml y se almacenan para su lectura posterior
- Uso básico de SimpleXML
- libxml_set_streams_context() - Configura el contexto de flujos para la próxima operación libxml

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open