Fonctions SimpleXML
SimpleXML
&reftitle.intro;
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.
&reftitle.required;
L'extension SimpleXML requière &php; 5.
&reference.simplexml.configure;
&reftitle.examples;
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 dans chacun d'entre eux. 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.
Fichier avec une chaîne XML qui sera inclus partout : example.php
PHP: Behind the Parser
Ms. Coder
Onlivia Actora
Mr. Coder
El Actór
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.
7
5
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.
Obtenir <literal><plot></literal>
movie[0]->plot; // "So this language. It's like..."
?>
]]>
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.
, nous affichons un . */
foreach ($xml->movie as $movie) {
echo $movie->plot, '
';
}
?>
]]>
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.
du premier .
* Affichage des attributs de é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;
}
}
?>
]]>
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.
movie->title == 'PHP: Behind the Parser') {
echo 'My favorite movie.';
}
htmlentities((string) $xml->movie->title);
?>
]]>
Utilisation de Xpath
SimpleXML inclut le support embarqué de Xpath.
Pour trouver tous les éléments <character> :
xpath('//character') as $character) {
echo $character->name, 'played by ', $character->actor, '
';
}
?>
]]>
'//' sert de joker. Pour spécifier un chemin absolu,
enlevez un slash.
Attribuer des valeurs
Les données dans SimpleXML n'ont pas à être constantes. L'objet permet
la manipulation de tous ces éléments.
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.
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.
loadXML('blah');
if (!$dom) {
echo 'Error while parsing the document';
exit;
}
$s = simplexml_import_dom($dom);
echo $s->book[0]->title;
?>
]]>
&reference.simplexml.functions;