# simplexml_load_file

(PHP 5, PHP 7, PHP 8)

simplexml_load_file — Convertit un fichier XML en objet

### Description

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

Convertit le document XML `filename` en un objet de type SimpleXMLElement.

### Liste de paramètres

`filename`

  Chemin vers le fichier XML

`class_name`

  Vous pouvez utiliser ce paramètre optionnel et ainsi, la fonction simplexml_load_file() retournera un objet de la classe spécifiée. Cette classe doit étendre la classe SimpleXMLElement.

`options`

  Opération de 'OU' logique des constantes d'option libxml.

`namespace_or_prefix`

  Préfixe ou l'URI de l'espace de noms.

`is_prefix`

  `true` si `namespace_or_prefix` est un préfixe, `false` si c'est l'URI ; par défaut, `false`.

### Valeurs de retour

Retourne un objet de la classe SimpleXMLElement dont les propriétés contiennent les données du document XML, ou `false` si une erreur survient.

Avertissement

Cette fonction peut retourner `false`, mais elle peut aussi retourner une valeur équivalent à `false`. Veuillez lire la section sur les booléens pour plus d'informations. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

### Erreurs / Exceptions

Produit un message d'erreur de niveau `E_WARNING` pour chaque erreur trouvée dans les données XML.

Astuce

Utilisez la fonction libxml_use_internal_errors() pour supprimer toutes les erreurs XML, et la fonction libxml_get_errors() pour les parcourir.

### Exemples

Exemple #1 Interprétation d'un document XML

`<?php
// Le fichier examples/book.xml contient un document XML avec un élément racine
// et au moins un élément /[racine]/title.
if (file_exists('examples/book.xml')) {
$xml = simplexml_load_file('examples/book.xml');
print_r($xml);
} else {
exit('Echec lors de l\'ouverture du fichier examples/test.xml.');
}
?>`

Ce script affichera, en cas de succès :

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

À partir de là, vous pouvez utiliser `$xml->title` et tout autre élément.

### Voir aussi

- simplexml_load_string() - Convertit une chaîne XML en objet
- SimpleXMLElement::__construct() - Crée un nouvel objet SimpleXMLElement
- Traitement des erreurs XML
- libxml_use_internal_errors() - Désactive le rapport d'erreur libxml et les stocke pour lecture ultérieure
- Utilisation de base SimpleXML
- libxml_set_streams_context() - Configure le contexte de flux pour la prochaine opération libxml