| 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 : Manuel DOM
lien : Cours et tutoriels XML en PHP
|
| 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 );
|
|
| 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 );
}
|
|
| 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().
|
| 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 ' );
|
|
| 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 (' /*/*/* ' );
foreach ($ noeuds as $ noeud ) {
if ($noeud ->nodeType = = XML_DOCUMENT_NODE) {
$document ->removeChild ($document ->documentElement );
} else {
$noeud ->parentNode ->removeChild ($ noeud );
}
}
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.
|
| 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,
' timeout ' = > 10
)
)
);
libxml_set_streams_context($ contexte );
$ 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.
|
| 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 ->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.
|