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.
L'extension SimpleXML requiert PHP 5.
L'extension SimpleXML est activé par défaut. Pour la désactiver, utilisez l'option de configuration --disable-simplexml .
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 2412. 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ó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 2413. Obtenir <plot>
<?php
include
'example.php'
;
$xml
= new
SimpleXMLElement
(
$xmlstr
);
echo
$xml
->
movie
[
0
]->
plot
;
// "So this language. It's like..."
?>
Exemple 2414. 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 2415. 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 2416. 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 2417. 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 2418. 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 2419. 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 2420. 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
;
?>