CXLI. Fonctions SimpleXML

Introduction

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

Pré-requis

L'extension SimpleXML requiert PHP 5.

Installation

L'extension SimpleXML est activé par défaut. Pour la désactiver, utilisez l'option de configuration --disable-simplexml.

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 inclurons dans chacun d'entre eux. Le contenu de ce fichier est illustré par l'exemple qui suit. Autrement, 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 apparaît 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 = new SimpleXMLElement($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 techniques normales d'itération peuvent être appliquées.


<?php

include 'example.php';



$xml = new SimpleXMLElement($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 = new SimpleXMLElement($xmlstr);



/* Accès au node <rating> du premier <movie>.

 * Affichage des attributs de <rating> également. */

foreach ($xml->movie[0]->rating as $rating) {

    switch((string) $rating['type']) { // Récupération des attributs comme indices d'éléments

    case 'thumbs':

        echo $rating, ' thumbs up';

        break;

    case 'stars':

        echo $rating, ' stars';

        break;

    }

}

?>

Exemple 5. Comparaison des éléments et des attributs avec du texte

Pour comparer un élément ou un attribut avec une chaîne de caractères ou pour le passer à une fonction qui nécessite une chaîne de caractères, vous devez le transtiper en une chaîne en utilisant (string). Sinon, PHP traitera l'élément comme un objet.


<?php     

include 'example.php';



$xml = new SimpleXMLElement($xmlstr);



if ((string) $xml->movie->title == 'PHP: Behind the Parser') {

    echo 'My favorite movie.';

}



htmlentities((string) $xml->movie->title);

?>

Exemple 6. Utilisation de Xpath

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


<?php

include 'example.php';

$xml = new SimpleXMLElement($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 7. Attribuer des valeurs

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


<?php

include 'example.php';

$xml = new SimpleXMLElement($xmlstr);



$xml->movie[0]->characters->character[0]->name = 'Miss Coder';



echo $xml->asXML();

?>

L'exemple précédent affichera un nouveau document XML, tout comme l'original mise à part que le nouveau document XML définit Ms. Coder à Miss Coder.

Exemple 8. Ajout d'éléments et d'attributs

Depuis PHP 5.1.3, SimpleXML a reçu l'abilité d'ajouter facilement des enfants et des attributs.


<?php

include 'example.php';

$xml = new SimpleXMLElement($xmlstr);



$character = $xml->movie[0]->characters->addChild('character');

$character->addChild('name', 'Mr. Parser');

$character->addChild('actor', 'John Doe');



$rating = $xml->movie[0]->addChild('rating', 'PG');

$rating->addAttribute('type', 'mpaa');



echo $xml->asXML();

?>

Le code ci-dessus sortira un document XML basé sur l'original mais ayant un nouveau personnage et résultat.

Exemple 9. 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
SimpleXMLElement->addAttribute() -- Ajoute un attribut à l'élément SimpleXML
SimpleXMLElement->addChild() -- Ajoute un élément enfant au noeud XML
SimpleXMLElement->asXML() -- Retourne une chaîne XML basée sur un élément SimpleXML
SimpleXMLElement->attributes() -- Identifie les attributs d'un élément
SimpleXMLElement->children() -- Trouve les enfants d'une node
SimpleXMLElement->__construct() -- Crée un nouvel objet SimpleXMLElement
SimpleXMLElement->getDocNamespaces() -- Retourne les espaces de noms déclarés dans un document
SimpleXMLElement->getName() -- Récupère le nom d'un élément XML
SimpleXMLElement->getNamespaces() -- Retourne les espaces de noms utilisés dans un document
SimpleXMLElement->registerXPathNamespace() -- Crée un contexte préfixe/ns pour la prochaine requête XPath
SimpleXMLElement->xpath() -- Exécute une requête Xpath sur des données XML
simplexml_import_dom -- Construit un objet SimpleXMLElement à partir d'une node DOM
simplexml_load_file -- Convertit un fichier XML en objet
simplexml_load_string -- Convertit une chaîne XML en objet

Rechercher une fonction PHP

<- fonctions sdo fonctions snmp ->

Réseaux sociaux

|Plus d'options...

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

Nuage de mots clés

5 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

Références

Manuel PHP : http://be2.php.net, fonctions simplexml

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Structure du document

Réseaux sociaux
Nuage de mots clés
- Avertissement :
Références

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html

Aucun commentaire pour cette page

tection. Enregistrement IDDN n° 5329-3821
Document créé le 21/09/06 00:58, dernière modification le Vendredi 17 Juin 2011, 12:12
Source du document imprimé : http://www.gaudry.be/php-rf-ref.simplexml.html Document affiché 1 fois ce mois de Juin.
St.Gaudry©07.01.02