Manuel PHP
PrécédentSuivant

XCVIII. Fonctions SimpleXML

Introduction

Avertissement

Ce module est EXPERIMENTAL. Cela signifie que le comportement de ces fonctions, leurs noms et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez ce module à vos risques et périls.

L'extension SimpleXML fournit des outils très simples et faciles à utiliser de convertir du XML en un objet qui peut être manipulé avec ses propriétés et les itérateurs de tableaux.

Installation

Cette extension n'est disponible que si PHP a été configuré avec l'option --enable-simplexml. Le script de configuration de PHP le fait par défaut.

Exemples

Plusieurs exemples de ce chapitre requièrent une chaîne XML. Plutôt que de la repéter à chaque exemple, nous allons la placer dans un fichier que nous incluerons à chaque exemple. Le contenu de ce fichier est montré dans l'exemple qui suit. Alternativement, vous pouvez créer un document XML et le lire avec simplexml_load_file().

Exemple 1. Fichier avec une chaîne XML qui sera inclus partout : example.php

<?php
$xmlstr = <<<XML
<?xml version='1.0' standalone='yes'?>
<movies>
<movie>
  <title>PHP: Behind the Parser</title>
  <characters>
   <character>
    <name>Ms. Coder</name>
    <actor>Onlivia Actora</actor>
   </character>
   <character>
    <name>Mr. Coder</name>
    <actor>El Act&oacute;r</actor>
   </character>
  </characters>
  <plot>
   So, this language. It's like, a programming language. Or is it a
   scripting language? All is revealed in this thrilling horror spoof
   of a documentary.
  </plot>
  <rating type="thumbs">7</rating>
  <rating type="stars">5</rating>
</movie>
</movies>
XML;
?>

La simplicité de SimpleXML apparait plus clairement lorsqu'on essaye d'extraire une chaîne ou un nombre d'un document XML basique.

Exemple 2. Obtenir <plot>

<?php
include 'example.php';

$xml = simplexml_load_string($xmlstr);

echo $xml->movie[0]->plot; // "So this language. It's like..."
?>

Exemple 3. Accéder à un élément non-unique avec SimpleXML

Lorsque plusieurs instances d'un élément existent en tant que fils d'un élément père unique, les technique normales d'itération peuvent être appliquées.

<?php
include 'example.php';

$xml = simplexml_load_string($xmlstr);

/* Pour chaque <movie>, nous affichons un <plot>. */
foreach ($xml->movie as $movie) {
   echo $movie->plot, '<br />';
}

?>

Exemple 4. Utilisation des attributs

Jusque là, nous n'avons couvert que la lecture des noms d'éléments, et leurs valeurs. SimpleXML peut aussi atteindre leurs attributs. L'accès aux attributs d'un élément se fait de la même façon que l'accès aux éléments d'un tableau.

<?php
include 'example.php';

$xml = simplexml_load_string($xmlstr);

/* Access the <rating> nodes of the first movie.
* Output the rating scale, too. */
foreach ($xml->movie[0]->rating as $rating) {
    switch($rating['type']) { // Get attributes as element indices
    case 'thumbs':
        echo $rating, ' thumbs up';
        break;
    case 'stars':
        echo $rating, ' stars';
        break;
    }
}
?>

Exemple 5. Utilisation de Xpath

SimpleXML inclut le support embarqué de Xpath. Pour trouver tous les éléments <character> :

<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);

foreach($xml->xpath('//character') as $character) {
    echo $character->name, 'played by ', $character->actor, '<br />';
}
?>

'//' sert de joker. Pour spécifier un chemin absolu, enlevez un slash.

Exemple 6. Attribuer des valeurs

Les donnés dans SimpleXML n'ont pas à être constantes. L'objet permet la manipulation de tous ces éléments.

<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);

$xml->movie[0]->actor[0]->age = '21';

echo $xml->asXML();
?>

The above code will output a new XML document, just like the original, except that the new XML will define Ms. Coder's age as 21.

Exemple 7. Interopérabilité DOM

PHP possède un mécanisme pour convertir les nodes XML entre les formats SimpleXML et DOM. Cet exemple montre comment changer un élément DOM en SimpleXML.

<?php
$dom = new domDocument;
$dom->loadXML('<books><book><title>blah</title></book></books>');
if (!$dom) {
     echo 'Error while parsing the document';
     exit;
}

$s = simplexml_import_dom($dom);

echo $s->book[0]->title;
?>

Table des matières
simplexml_element->asXML --  Retourne une chaîne XML basée sur un élément SimpleXML.
simplexml_element->attributes --  Identifie les attributs d'un élément.
simplexml_element->children --  Trouve les enfants d'une node.
simplexml_element->xpath --  Exécute une requête Xpath sur des données XML.
simplexml_import_dom --  Construit un objet simplexml_element à partir d'une node DOM.
simplexml_load_file --  Convertit un fichier XML en objet.
simplexml_load_string --  Convertit un chaîne XML en objet.
PrécédentSommaireSuivant
shmop_writeNiveau supérieursimplexml_element->asXML