Accueil
Club Emploi Blogs   TV   Dév. Web PHP XML Python Autres 2D-3D-Jeux Sécurité Windows Linux PC Mac
Accueil Conception Java DotNET Visual Basic  C  C++ Delphi Eclipse MS-Office SQL & SGBD Oracle  4D  Business Intelligence
logo
Sommaire > XML > DOM (PHP 5)
        Qu'est-ce que DOM ?
        Comment installer DOM pour PHP5 ?
        Comment obtenir l'élément racine du document ?
        Comment ajouter un élément à un objet DOM ?
        Comment affecter un attribut à un élément DOM ?
        Comment enregistrer un document DOM ?
        Comment formater un document XML pour affichage ?
        Comment supprimer les noeuds correspondant à une expression XPath en PHP5 ?
        Comment lire un document XML distant en précisant des entêtes HTTP particulières ?
        Comment écrire un document XML sur un serveur FTP ?



Qu'est-ce que DOM ?
auteur : Guillaume Rossolini
DOM est une extension pour PHP 5 permettant, tout comme DOM XML en PHP4, de lire et de générer des documents au format XML.

Toute une série de classes est mise à disposition afin de permettre ue gestion très fine des documents.

lien : fr Manuel DOM
lien : fr Cours et tutoriels XML en PHP

Comment installer DOM pour PHP5 ?
auteur : Guillaume Rossolini
Cette extension n'est pas en PECL mais dans la distribution core, ce qui la rend disponible simplement par l'activation dans php.ini suivie d'un redémarrage d'Apache.

lien : faq http://php.developpez.com/faq/tmp/bibliotheques-extensions/?page=divers#extension_installer
lien : http://es2.php.net/manual/fr/ref.dom.php

Comment obtenir l'élément racine du document ?
auteur : Julp
Tout objet DomDocument possède une variable d'instance documentElement, en lecture seule. Il est donc strictement inutile de passer par exemple par la méthode getElementsByTagName ou autres :
$dom = DomDocument::load('monFichier.xml');
$racine = $dom->documentElement;
printf("L'élément racine se nomme : %s", $racine->nodeName);

Comment ajouter un élément à un objet DOM ?
auteur : Guillaume Rossolini
Au moyen des méthodes createElement() et appendChild() :
$document = new DOMDocument();
 
$XMLRoot = $document->createElement('Utilisateurs');
$document->appendChild($XMLRoot);

On peut ensuite ajouter d'autres éléments à l'objet $XMLRoot :
$users = array
(
array('name' => 'Yogui', 'password' => '1234'),
array('name' => 'BrYs', 'password' => '4321')
);

$document = new DOMDocument();

$XMLRoot = $document->createElement('Utilisateurs');
$document->appendChild($XMLRoot);

foreach($users as $user)
{
$XMLUser = $document->createElement('user');
$XMLRoot->appendChild($XMLUser);

$XMLName = $document->createElement('name', $user['name']);
$XMLUser->appendChild($XMLName);

$XMLPassword = $document->createElement('password', $user['password']);
$XMLUser->appendChild($XMLPassword);
}

Comment affecter un attribut à un élément DOM ?
auteur : Guillaume Rossolini
Au moyen de la méthode setAttribute() :
$document = new DOMDocument();

$XMLName = $document->createElement('password', $user['password']);
$XMLName->setAttribute('crypted', 0);
$XMLUser->appendChild($XMLName);

Notez que cette méthode peut être appelée à n'importe quel moment du script, tant que l'objet est accessible. Ici par exemple, vous pouvez intervertir les appels à appendChild() et setAttribute().


Comment enregistrer un document DOM ?
auteurs : Guillaume Rossolini, Julp
Il faut terminer le script par un appel à l'une des méthodes suivantes :
Affichage dans le navigateur :
$document = new DOMDocument();
 
$XMLRoot = $document->createElement('Utilisateurs');
$document->appendChild($XMLRoot);

echo htmlentities($document->saveXML(), ENT_QUOTES, 'ISO-8859-1');
Enregistrement dans un fichier :
$document = new DOMDocument();
 
$XMLRoot = $document->createElement('Utilisateurs');
$document->appendChild($XMLRoot);

$document->save('users.xml');

Comment formater un document XML pour affichage ?
auteur : Julp
Chaque instance de DomDocument dispose de deux variables intervenant dans la production d'une sortie humainement lisible :
  • preserveWhiteSpace doit être mise à la valeur fausse avant le chargement du document XML afin que tous les noeuds textuels composés de blanc, fruits du formatage, soient ignorés ;
  • formatOuput doit être mis à la valeur vraie avant l'écriture du document (méthodes save*) afin qu'il soit indenté.
Exemple :
// 1. Créer un objet DomDocument "vierge"
$dom = new DomDocument;
// 2. Indiquer que les noeuds texte constitués de blancs soient ignorés
$dom->preserveWhiteSpace = FALSE;
// 3. Indiquer qu'il devra être formaté lors de son écriture (peut être remis à plus tard)
$dom->formatOutput = TRUE;
// 4. Charger votre document
$dom->load('monFichier.xml'); // Pour un fichier (même distant)
$dom->loadXML($maChaineXML); // Pour une chaîne de caractères
 
// Manipuler, optionnellement, l'arbre ...
 
// 5. Sauvegarder le document
$dom->save('monFichier.xml'); // Pour une sortie dans un fichier
$output = $dom->saveXML(); // Pour obtenir le résultat sous la forme d'une chaîne de caractères

Comment supprimer les noeuds correspondant à une expression XPath en PHP5 ?
auteur : Julp
<?php
define('FICHIER_XML', 'un_fichier_xml.xml');
define('DOCUMENT_FORMATE', TRUE);

$document = new DOMDocument;
$document->preserveWhiteSpace = !DOCUMENT_FORMATE;
$document->formatOutput = DOCUMENT_FORMATE;
$document->load(FICHIER_XML);
$xpath = new DOMXPath($document);
$noeuds = $xpath->query('/*/*/*'); // Tous les noeuds ayant deux ancêtres
foreach ($noeuds as $noeud) {
if ($noeud->nodeType == XML_DOCUMENT_NODE) {
$document->removeChild($document->documentElement);
} else {
$noeud->parentNode->removeChild($noeud);
}
}
// Ecraser le fichier existant avec les modifications apportées
//$document->save(FICHIER_XML);

// Affichage pour test :
header('Content-type: text/plain');
echo $document->saveXML();
?>
La constante booléenne DOCUMENT_FORMATE, définie communément aux deux scripts, permet de tenir compte des fichiers XML indentés pour qu'il soit plus facilement lisible et éditable par l'Homme. Pour que cela soit possible, il faut, à l'ouverture du fichier XML en lecture, indiquer que les espaces utilisés pour cette indentation doivent être ignorés (il faut affecter une valeur fausse à l'attribut preserveWhiteSpace de l'objet correspondant au document). On doit ensuite lui faire savoir que le document doit être formaté lors de sa sortie, ce que nous faisons via l'attribut formatOutput du document que l'on fixe à la valeur vraie.


Comment lire un document XML distant en précisant des entêtes HTTP particulières ?
auteur : Julp
On peut avoir besoin de modifier les entêtes que PHP fait parvenir par défaut lors d'une communication avec un serveur HTTP. Il vous est notamment possible de modifier le type de requête pour POST (GET étant la méthode par défaut) et d'y adjoindre différentes données, de fixer un délai d'expiration pour la requête, de limiter le nombre de redirections dont vous pourriez faire l'objet, de vous faire passer pour un navigateur standard, etc. Pour ce faire, il faut créer un nouveau contexte (fonction stream_context_create) pour modifier le comportement par défaut, puis le rendre opérationnel grâce à la fonction libxml_set_streams_context qui le fera valoir à la librairie de plus bas niveau libxml sur laquelle les extensions DOM et SimpleXML sont toutes deux basées.
Exemple préférant, entre autres, la méthode POST :
$post = array(
    'selection' => array(1, 10, 3),
    'titre' => 'Test',
    'submit' => 'valider'
);
$contexte = stream_context_create(
    array(
        'http' => array(
            'method' => 'POST',
            'header' => "User-Agent: PHP5 & DOM/SimpleXML\r\nContent-type: application/x-www-form-urlencoded",
            'content' => http_build_query($post),
            'max_redirects' => 10, /* Suivre, au maximum, 10 redirections (requiert une version >= à 5.1.0) */
            'timeout' => 10 /* Ne sera honoré que sur les versions >= à 5.2.1 */
        )
    )
);
libxml_set_streams_context($contexte);
// DOM
$dom = DomDocument::load('https://login:motDePasse@www.monsite.fr/prive/flux.php');
Ces exemples ne seront valables que si :
  • allow_url_fopen est à la valeur On ;
  • Les flux http(s) sont gérés par PHP.
Consultez la sortie de phpinfo() pour obtenir ces informations.


Comment écrire un document XML sur un serveur FTP ?
auteur : Julp
Par défaut, PHP, par l'intermédiaire de son gestionnaire de flux FTP, refusera d'écraser un fichier distant existant. Cette situation vous sera vraisemblablement indiquée par l'erreur suivante :
Remote file already exists and overwrite context option not specified.
La solution consite à modifier les options par défaut en créant un contexte où l'on modifie la valeur du paramètre overwrite puis à le fournir à la fonction libxml_set_streams_context, servant à configurer le flux pour la prochaine opération de la librairie libxml sous-jacente, avant de faire appel aux fonctions d'écriture :
$contexte = stream_context_create(
    array(
        'ftp' => array('overwrite' => TRUE)
    )
);
libxml_set_streams_context($contexte);
// DOM
$dom->save('ftp://login:motDePasse@ftp.monsite.fr/offline/temp.xml');
Cette opération dépend de la configuration de votre serveur :
  • allow_url_fopen doit être à On ;
  • Les flux ftp(s) doivent être gérés par PHP.
Consultez la sortie de phpinfo() pour obtenir ces informations.



Consultez les autres F.A.Q.


Les sources présentés sur cette page sont libres de droits, et vous pouvez les utiliser à votre convenance. Par contre cette page de présentation de ces sources constitue une oeuvre intellectuelle protégée par les droits d'auteurs. Copyright ©2003  Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.

Vos questions techniques : forum d'entraide Accueil - Publiez vos articles, tutoriels, cours et rejoignez-nous dans l'équipe de rédaction du club d'entraide des développeurs francophones. Nous contacter - Copyright 2000..2005 www.developpez.com