 |
|
CLVI. XMLReader functions
Introduction
L'extension XMLReader un analyseur XML Pull. Le lecteur fonctionne comme un curseur qui avance sur le flux du document et s'arrête à chaque noeud sur le chemin.
Installation
L'extension XMLReader est disponible dans PECL pour PHP 5.0 et est inclue par défaut dans PHP 5.1. Elle peut être activée en ajoutant l'argument --with-xmlreader à votre ligne de configuration. L'extension libxml est requise.
Classes pré-définies
XMLReader
Méthodes
XMLReader->close() - Ferme l'entrée XMLReader
XMLReader->expand() - Exporte le noeud courant comme un noeud DOM
XMLReader->getAttribute() - Récupère une valeur d'attribut par nom
XMLReader->getAttributeNo() - Récupère une valeur d'attribut par position
XMLReader->getAttributeNS() - Récupère une valeur d'attribut par nom et URI
XMLReader->getParserProperty() - Indique si la propriété de l'analyseur est fixée ou non
XMLReader->isValid() - Indique si le document est valide
XMLReader->lookupNamespace() - Récupère l'URI du préfixe dans la portée du noeud
XMLReader->moveToAttribute() - Positionne le lecteur sur l'attribut par nom
XMLReader->moveToAttributeNo() - Positionne le lecteur sur l'attribut par index
XMLReader->moveToAttributeNs() - Positionne le lecteur sur l'attribut par nom et URI
XMLReader->moveToElement() - Déplace l'élément parent du noeud de l'attribut courant
XMLReader->moveToFirstAttribute() - Déplace au premier attribut du noeud
XMLReader->moveToNextAttribute() - Déplace au prochain attribut du noeud
XMLReader->next() - Déplace à l'élément suivant en sautant les enfants
XMLReader->open() - Fixe l'URI à être analysé
XMLReader->read() - Déplace au prochain noeud dans le flux
XMLReader->setParserProperty() - Fixe une propriété de l'analyseur
XMLReader->setRelaxNGSchema() - Fixe l'URI du schéma RelaxNG pour validation
XMLReader->setRelaxNGSchemaSource() - Fixe la chaîne de caractères contenant le schéma RelaxNG pour validation
XMLReader->XML() - Fixe la chaîne de caractères de données pour être analysée
Propriétés
Tableau 1.
| Nom | Type | Lecture seule | Description |
|---|---|---|---|
| attributeCount | int | oui | Le nombre d'attributs dans le noeud |
| baseURI | string | oui | La base URI du noeud |
| depth | int | oui | Profondeur du noeud dans l'arbre démarrant à 0 |
| hasAttributes | bool | oui | Indique si le noeud a des attributs |
| hasValue | bool | oui | Indique si le noeud a une valeur de texte |
| isDefault | bool | oui | Indique si l'attribut est par défaut à partir du DTD |
| isEmptyElement | bool | oui | Indique si le noeud est un élément vide |
| localName | string | oui | Le nom local du noeud |
| name | string | oui | Le noeud qualifié du noeud |
| namespaceURI | string | oui | L'URI de l'espace de nom associé avec le noeud |
| nodeType | int | oui | Le type de noeud pour le noeud |
| prefix | string | oui | Le préfixe de l'espace de nom associé avec le noeud |
| value | string | oui | La valeur du texte du noeud |
| xmlLang | string | oui | La portée xml:lang dans lequel le noeud réside |
Constantes pré-définies
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.
Tableau 2. Types de Noeud XMLReader
| Constante | Valeur | Description |
|---|---|---|
| XMLREADER_NONE (entier) | 0 | Non un type de noeud |
| XMLREADER_ELEMENT (entier) | 1 | Début d'élément |
| XMLREADER_ATTRIBUTE (entier) | 2 | Noeud attribut |
| XMLREADER_TEXT (entier) | 3 | Noeud texte |
| XMLREADER_CDATA (entier) | 4 | Noeud CDATA |
| XMLREADER_ENTITY_REF (entier) | 5 | Noeud Référence Entité |
| XMLREADER_ENTITY (entier) | 6 | Noeud Déclaration Entité |
| XMLREADER_PI (entier) | 7 | Noeud Traitement d'Instruction |
| XMLREADER_COMMENT (entier) | 8 | Noeud commentaire |
| XMLREADER_DOC (entier) | 9 | Noeud document |
| XMLREADER_DOC_TYPE (entier) | 10 | Noeud Type document |
| XMLREADER_DOC_FRAGMENT (entier) | 11 | Noeud Fragment Document |
| XMLREADER_NOTATION (entier) | 12 | Noeud notation |
| XMLREADER_WHITESPACE (entier) | 13 | Noeud blanc (espace) |
| XMLREADER_SIGNIFICANT_WHITESPACE (entier) | 14 | Noeud blanc (espace) important |
| XMLREADER_END_ELEMENT (entier) | 15 | Fin d'élément |
| XMLREADER_END_ENTITY (entier) | 16 | Fin d'entité |
| XMLREADER_XML_DECLARATION (entier) | 17 | Noeud Déclaration XML |
Tableau 3. Options Analyseur XMLReader
| Constante | Valeur | Description |
|---|---|---|
| XMLREADER_LOADDTD (entier) | 1 | Charge DTD mais ne valide pas |
| XMLREADER_DEFAULTATTRS (entier) | 2 | Charge DTD et attributs par défaut mais ne valide pas |
| XMLREADER_VALIDATE (entier) | 3 | Charge DTD et valide pendant l'analyse |
| XMLREADER_SUBST_ENTITIES (entier) | 4 | Substitue les entités et agrandit les références |
- Table des matières
- XMLReader->close() -- Ferme l'entrée XMLReader
- XMLReader->expand() -- Retourne une copie du noeud courant comme un noeud d'objet DOM
- XMLReader->getAttribute() -- Récupère la valeur d'un attribut par nom
- XMLReader->getAttributeNo() -- Récupère la valeur d'un attribut par index
- XMLReader->getAttributeNS() -- Récupère la valeur d'un attribut par nom local et URI
- XMLReader->getParserProperty() -- Indique si la propriété spécifiée a été fixée
- XMLReader->isValid() -- Indique si le document analysé est valide
- XMLReader->lookupNamespace() -- Consulte l'espace de nom pour un préfixe
- XMLReader->moveToAttribute() -- Déplace un curseur à un attribut nommé
- XMLReader->moveToAttributeNo() -- Déplace le curseur à un attribut par index
- XMLReader->moveToAttributeNs() -- Déplace le curseur à un attribut d'espace de nom
- XMLReader->moveToElement() -- Positionne le curseur sur l'élément parent de l'attribut courant
- XMLReader->moveToFirstAttribute() -- Positionne le curseur sur le premier attribut
- XMLReader->moveToNextAttribute() -- Positionne le curseur sur le prochain attribut
- XMLReader->next() -- Déplace le curseur au prochain noeud en sautant tous les sous arbres
- XMLReader->open() -- Fixe le URI contenant le XML à analyser
- XMLReader->read() -- Déplace au prochain noeud dans le document
- XMLReader->setParserProperty() -- Fixe ou supprime des options pour l'analyseur
- XMLReader->setRelaxNGSchema() -- Fixe le nom du fichier ou l'URI pour le Schéma RelaxNG
- XMLReader->setRelaxNGSchemaSource() -- Fixe les donneés contenant le Scéhma RelaxNG
- XMLReader->XML() -- Fixe les données contenant le XML à analyser
| Précédent | Sommaire | Suivant |
| xmlrpc_set_type | Niveau supérieur | XMLReader->close() |
Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:02:00