Last updated: Fri, 10 Oct 2008

La classe DOMDocument

Introduction

Représente un document HTML ou XML entier ; ce sera la racine de l'arbre document.

Synopsis de la classe

DOMDocument

DOMDocument étend DOMNode {

/* Propriétés */

readonly public string $actualEncoding ;

readonly public DOMConfiguration $config ;

readonly public DOMDocumentType $doctype ;

readonly public DOMElement $documentElement ;

public string $documentURI ;

public string $encoding ;

public bool $formatOutput ;

readonly public DOMImplementation $implementation ;

public bool $preserveWhiteSpace =true ;

public bool $recover ;

public bool $resolveExternals ;

public bool $standalone ;

public bool $strictErrorChecking =true ;

public bool $substituteEntities ;

public bool $validateOnParse =false ;

public string $version ;

readonly public string $xmlEncoding ;

public bool $xmlStandalone ;

public string $xmlVersion ;

/* Méthodes */

DOMDocument::__construct ([ string $version [, string $encoding ]] )

DOMAttr DOMDocument::createAttribute ( string $name )

DOMAttr DOMDocument::createAttributeNS ( string $namespaceURI , string $qualifiedName )

DOMCDATASection DOMDocument::createCDATASection ( string $data )

DOMComment DOMDocument::createComment ( string $data )

DOMDocumentFragment DOMDocument::createDocumentFragment ( void )

DOMElement DOMDocument::createElement ( string $name [, string $value ] )

DOMElement DOMDocument::createElementNS ( string $namespaceURI , string $qualifiedName [, string $value ] )

DOMEntityReference DOMDocument::createEntityReference ( string $name )

DOMProcessingInstruction DOMDocument::createProcessingInstruction ( string $target [, string $data ] )

DOMText DOMDocument::createTextNode ( string $content )

DOMElement DOMDocument::getElementById ( string $elementId )

DOMNodeList DOMDocument::getElementsByTagName ( string $name )

DOMNodeList DOMDocument::getElementsByTagNameNS ( string $namespaceURI , string $localName )

DOMNode DOMDocument::importNode ( DOMNode $importedNode [, bool $deep ] )

mixed DOMDocument::load ( string $filename [, int $options ] )

bool DOMDocument::loadHTML ( string $source )

bool DOMDocument::loadHTMLFile ( string $filename )

mixed DOMDocument::loadXML ( string $source [, int $options ] )

void DOMDocument::normalizeDocument ( void )

bool DOMDocument::registerNodeClass ( string $baseclass , string $extendedclass )

bool DOMDocument::relaxNGValidate ( string $filename )

bool DOMDocument::relaxNGValidateSource ( string $source )

int DOMDocument::save ( string $filename [, int $options ] )

string DOMDocument::saveHTML ( void )

int DOMDocument::saveHTMLFile ( string $filename )

string DOMDocument::saveXML ([ DOMNode $node [, int $options ]] )

bool DOMDocument::schemaValidate ( string $filename )

bool DOMDocument::schemaValidateSource ( string $source )

bool DOMDocument::validate ( void )

int DOMDocument::xinclude ([ int $options ] )

/* Méthodes héritées */

DOMNode DOMNode::appendChild ( DOMNode $newnode )

DOMNode DOMNode::cloneNode ([ bool $deep ] )

bool DOMNode::hasAttributes ( void )

bool DOMNode::hasChildNodes ( void )

DOMNode DOMNode::insertBefore ( DOMNode $newnode [, DOMNode $refnode ] )

bool DOMNode::isDefaultNamespace ( string $namespaceURI )

bool DOMNode::isSameNode ( DOMNode $node )

bool DOMNode::isSupported ( string $feature , string $version )

string DOMNode::lookupNamespaceURI ( string $prefix )

string DOMNode::lookupPrefix ( string $namespaceURI )

void DOMNode::normalize ( void )

DOMNode DOMNode::removeChild ( DOMNode $oldnode )

DOMNode DOMNode::replaceChild ( DOMNode $newnode , DOMNode $oldnode )

}

Propriétés

actualEncoding: Obsolète. L'encodage actuel du document, en lecture seule, équivalent àencoding.
config: Obsolète. Configuration utilisée lorsque DOMDocument::normalizeDocument() est appelé.
doctype: Le doctype associé au document.
documentElement: C'est un attribut de convenence, qui permet un accès direct au noeud fils, qui est l'élément document du document.
documentURI: La localisation du document, ou NULL si indéfini.
encoding: L'encodage du document, tel que spécifié par la déclaration XML. Cet attribut n'est pas présent dans la spécification DOM Level 3 finale, mais représente la seule façon de manipuler l'encodage du document XML dans cette implémentation.
formatOutput: Formate la sortie avec une jolie indentation et des espaces supplémentaires.
implementation: L'objet DOMImplementation qui gère ce document.
preserveWhiteSpace: Ne pas supprimer les espaces redondants. Vaut par défaut TRUE.
recover: Propriétaire. Active le mode "recovery", i.e. tente d'analyser un document mal formé. Cet attribut ne fait pas parti de la spécification DOM et est spécifique à libxml.
resolveExternals: Définissez-le à TRUE pour charger des entités externes depuis la déclaration doctype. C'est utile pour inclure des entités dans vos documents XML.
standalone: Obsolète. Si le document est "standalone", ou non, tel que spécifié par la déclaration XML, correspondant à xmlStandalone.
strictErrorChecking: Lance une DOMException en cas d'erreur. Par défaut, vaut TRUE.
substituteEntities: Propriétaire. Si l'on doit ou non substituer les entités. Cet attribut ne fait pas parti de la spécification DOM et est spécifique à libxml.
validateOnParse: Charge et valide la DTD. Par défaut, vaut FALSE.
version: Obsolète. Version du XML, correspond à xmlVersion
xmlEncoding: Un attribut spécifiant l'encodage du document. Il vaut NULL lorsque l'encodage n'est pas spécifié, ou lorsqu'il est inconnu, comme c'est le cas lorsque le document a été créé en mémoire.
xmlStandalone: Un attribut spécifiant si le document est "standalone". Il vaut FALSE lorsque non spécifié.
xmlVersion: Un attribut spécifiant le numéro de version du document. S'il n'y a pas de déclaration et si le document supporte la fonctionnalité "XML", la valeur sera "1.0".

Voir aussi

» spécification W3C de Document

Sommaire

DOMDocument::__construct — Crée un nouvel objet DOMDocument
DOMDocument::createAttribute — Crée un nouvel attribut
DOMDocument::createAttributeNS — Crée un nouvel attribut avec un espace de noms associé
DOMDocument::createCDATASection — Crée un nouveau noeud cdata
DOMDocument::createComment — Crée un nouveau noeud de commentaire
DOMDocument::createDocumentFragment — Crée un nouveau fragment de document
DOMDocument::createElement — Crée un nouveau noeud
DOMDocument::createElementNS — Crée un nouveau noeud avec un espace de noms associé
DOMDocument::createEntityReference — Crée un nouveau noeud de référence d'entité
DOMDocument::createProcessingInstruction — Crée un nouveau noeud PI
DOMDocument::createTextNode — Crée un nouveau noeud de texte
DOMDocument::getElementById — Cherche un élément avec un certain identifiant
DOMDocument::getElementsByTagName — Cherche tous les éléments qui ont le nom de balise donné
DOMDocument::getElementsByTagNameNS — Recherche tous les éléments avec un nom de balise donné dans un espace de noms spécifié
DOMDocument::importNode — Importe un noeud dans le document courant
DOMDocument::load — Charge du XML depuis un fichier
DOMDocument::loadHTML — Charge du HTML à partir d'une chaîne de caractères
DOMDocument::loadHTMLFile — Charge du HTML à partir d'un fichier
DOMDocument::loadXML — Charge du XML depuis une chaîne de caractères
DOMDocument::normalizeDocument — Normalise le document
DOMDocument::registerNodeClass — Enregistre la classe étendue utilisée pour créer un type de base de noeud
DOMDocument::relaxNGValidate — Effectue une validation relaxNG sur le document
DOMDocument::relaxNGValidateSource — Effectue une validation relaxNG sur le document
DOMDocument::save — Sauvegarde l'arbre interne XML dans un fichier
DOMDocument::saveHTML — Sauvegarde le document interne dans une chaîne en utilisant un formatage HTML
DOMDocument::saveHTMLFile — Sauvegarde un document interne dans un fichier en utilisant un formatage HTML
DOMDocument::saveXML — Sauvegarde l'arbre interne XML dans une chaîne de caractères
DOMDocument::schemaValidate — Valide un document selon un schéma
DOMDocument::schemaValidateSource — Valide un document selon un schéma
DOMDocument::validate — Valide un document en se basant sur sa DTD
DOMDocument::xinclude — Remplace les XIncludes dans un objet DOMDocument

add a note User Contributed Notes
DOMDocument

Jochem Blok
15-May-2008 03:58


To indent a XML in a pretty way I use:



<?

$sXML = '<root><element><key>a</key><value>b</value></element></root>';

$doc = new DOMDocument();

$doc->preserveWhiteSpace = false;

$doc->formatOutput   = true;

$doc->loadXML($sXML);

echo $doc->saveXML();

?>

Fernando H
11-Apr-2008 09:48


Showing a quick example of how to use this class, just so that new users can get a quick start without having to figure it all out by themself. ( At the day of posting, this documentation just got added and is lacking examples. )



<?php



// Set the content type to be XML, so that the browser will   recognise it as XML.

header( "content-type: application/xml; charset=ISO-8859-15" );



// "Create" the document.

$xml = new DOMDocument( "1.0", "ISO-8859-15" );



// Create some elements.

$xml_album = $xml->createElement( "Album" );

$xml_track = $xml->createElement( "Track", "The ninth symphony" );



// Set the attributes.

$xml_track->setAttribute( "length", "0:01:15" );

$xml_track->setAttribute( "bitrate", "64kb/s" );

$xml_track->setAttribute( "channels", "2" );



// Create another element, just to show you can add any (realistic to computer) number of sublevels.

$xml_note = $xml->createElement( "Note", "The last symphony composed by Ludwig van Beethoven." );



// Append the whole bunch.

$xml_track->appendChild( $xml_note );

$xml_album->appendChild( $xml_track );



// Repeat the above with some different values..

$xml_track = $xml->createElement( "Track", "Highway Blues" );



$xml_track->setAttribute( "length", "0:01:33" );

$xml_track->setAttribute( "bitrate", "64kb/s" );

$xml_track->setAttribute( "channels", "2" );

$xml_album->appendChild( $xml_track );



$xml->appendChild( $xml_album );



// Parse the XML.

print $xml->saveXML();



?>



Output:

<Album>

  <Track length="0:01:15" bitrate="64kb/s" channels="2">

    The ninth symphony

    <Note>

      The last symphony composed by Ludwig van Beethoven.

    </Note>

  </Track>

  <Track length="0:01:33" bitrate="64kb/s" channels="2">Highway Blues</Track>

</Album>



If you want your PHP->DOM code to run under the .xml extension, you should set your webserver up to run the .xml extension with PHP ( Refer to the installation/configuration configuration for PHP on how to do this ).



Note that this:

<?php

$xml = new DOMDocument( "1.0", "ISO-8859-15" );

$xml_album = $xml->createElement( "Album" );

$xml_track = $xml->createElement( "Track" );

$xml_album->appendChild( $xml_track );

$xml->appendChild( $xml_album );

?>



is NOT the same as this:

<?php

// Will NOT work.

$xml = new DOMDocument( "1.0", "ISO-8859-15" );

$xml_album = new DOMElement( "Album" );

$xml_track = new DOMElement( "Track" );

$xml_album->appendChild( $xml_track );

$xml->appendChild( $xml_album );

?>



although this will work:

<?php

$xml = new DOMDocument( "1.0", "ISO-8859-15" );

$xml_album = new DOMElement( "Album" );

$xml->appendChild( $xml_album );

?>

add a note

DOMDocument::__construct

DOMComment::__construct

Last updated: Fri, 10 Oct 2008