L'extension DOM est le remplacement de l'extension
DOM XML en PHP 4.
Cette extension contient encore plusieurs anciennes fonctions
mais elles ne doivent plus être utilisées. En particulier, les fonctions
procédurales.
Cette extension vous permet de manipuler des documents XML avec l'API
DOM.
L'API de ce module suit, autant que possible, les standards niveau 2 de DOM.
En conséquent, l'API est pleinement orientée objets. Il est bien d'avoir
les standards DOM sous la main lors de l'utilisation de cette extension.
Ce module définit plusieurs classes, qui sont expliquées dans les tableaux suivants.
Les classes avec un équivalent dans les standards sont nommées DOMxxx.
La déclaration de type de document associée avec ce document.
documentElement
DOMElement
oui
C'est un attribut de convenance qui permet l'accès direct à l'enfant
d'un noeud qui est l'élément document de ce document.
documentURI
string
non
La localisation du document ou NULL si non défini.
encoding
string
non
formatOutput
bool
non
implementation
DOMImplementation
oui
L'objet DOMImplementation qui représente
ce document.
preserveWhiteSpace
bool
non
Ne pas supprimer les espaces redondants. Vaut TRUE par défaut.
recover
bool
non
resolveExternals
bool
non
Définir à TRUE pour charger les entités externes depuis une déclaration doctype.
Ceci est utile pour inclure des entités correspondants à des caractères dans
vos documents XML.
standalone
bool
non
strictErrorChecking
bool
non
Envoie une DOMException en cas d'erreurs. Vaut par défaut TRUE.
substituteEntities
bool
non
validateOnParse
bool
non
Charge et valide à nouveau la DTD. Vaut par défaut FALSE.
version
string
non
xmlEncoding
string
oui
Un attribut spécifiant, en tant que partie de la déclaration XML, l'encodage
de ce document. Il vaut NULL lorsqu'il n'et pas spécifié ou lorsqu'il
n'est pas connu, par exemple, lorsque le document a été créé en mémoire.
xmlStandalone
bool
non
Un attribut spécifiant, en tant que partie de la déclaration XML,
si oui ou non le document est autonome. Il vaut FALSE si non spécifié.
xmlVersion
string
non
Un attribut spécifiant, en tant que partie de la déclaration XML, le numéro
de version de ce document. S'il n'y a pas de déclaration et si le document
supporte la fonctionnalité "XML", la valeur sera "1.0".
L'identifiant public associé Ã l'entité si spécifiée, NULL sinon.
systemId
string
oui
L'identifiant système associé Ã l'entité si spécifié, NULL sinon.
Ceci peut être une URI absolue ou non.
notationName
string
oui
Pour les entités non-analysées, le nom de la notation pour cette entité.
Pour les entités analysées, ceci vaut NULL.
actualEncoding
string
non
Un attribut spécifiant l'encodage utilisé pour cette entité au moment
de l'analyse, lorsque c'est une entité analysée externe. Ceci vaut NULL
si c'est une entité du sous-ensemble externe ou si elle n'est pas connue.
encoding
string
oui
Un attribut spécifiant, en tant que partie de la déclaration texte, l'encodage
de cette entité, lorsque c'est une entité analysée externe. Ceci vaut
NULL sinon.
version
string
oui
Un attribut spécifiant, en tant que partie de la déclaration texte, le
numéro de version de cette entité, lorsque c'est une entité analysée externe.
Ceci vaut NULL sinon.
Les opérations DOM lancent des exceptions sous des circonstances particulières, i.e.,
lorsqu'une opération est impossible à effectuer pour des raisons de logique.
L'interface DOMImplementation fournit un nombre
de méthodes pour effectuer des opérations qui sont indépendant de toute instance
du model objet du document.
Ces constantes sont définies par cette
extension, et ne sont disponibles que si cette extension a été compilée avec
PHP, ou bien chargée au moment de l'exécution.
Si un appel à une méthode tel que insertBefore ou removeChild voudrait rendre le noeud
invalide avec le respect de la validation partielle, cette exception
sera exécutée et l'opération ne sera pas effectuée.
