Die Klasse XMLReader

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

Einführung

Die Erweiterung XMLReader ist ein fortschreitender XML-Parser (XML-Pull-Parser). Der Reader agiert wie ein Zeiger, der einen Datenstrom durchläuft und jeden vorbeikommenden Knoten der Reihe nach verarbeitet.

Klassenbeschreibung

class XMLReader {

/* Konstanten */

const int NONE = 0;

const int ELEMENT = 1;

const int ATTRIBUTE = 2;

const int TEXT = 3;

const int CDATA = 4;

const int ENTITY_REF = 5;

const int ENTITY = 6;

const int PI = 7;

const int COMMENT = 8;

const int DOC = 9;

const int DOC_TYPE = 10;

const int DOC_FRAGMENT = 11;

const int NOTATION = 12;

const int WHITESPACE = 13;

const int SIGNIFICANT_WHITESPACE = 14;

const int END_ELEMENT = 15;

const int END_ENTITY = 16;

const int XML_DECLARATION = 17;

const int LOADDTD = 1;

const int DEFAULTATTRS = 2;

const int VALIDATE = 3;

const int SUBST_ENTITIES = 4;

/* Eigenschaften */

public int $attributeCount;

public string $baseURI;

public int $depth;

public bool $hasAttributes;

public bool $hasValue;

public bool $isDefault;

public bool $isEmptyElement;

public string $localName;

public string $name;

public string $namespaceURI;

public int $nodeType;

public string $prefix;

public string $value;

public string $xmlLang;

/* Methoden */

public close(): bool

public expand(?DOMNode $baseNode = null): DOMNode|false

public getAttribute(string $name): ?string

public getAttributeNo(int $index): ?string

public getAttributeNs(string $name, string $namespace): ?string

public getParserProperty(int $property): bool

public isValid(): bool

public lookupNamespace(string $prefix): ?string

public moveToAttribute(string $name): bool

public moveToAttributeNo(int $index): bool

public moveToAttributeNs(string $name, string $namespace): bool

public moveToElement(): bool

public moveToFirstAttribute(): bool

public moveToNextAttribute(): bool

public next(?string $name = null): bool

public static open(string $uri, ?string $encoding = null, int $flags = 0): bool|XMLReader

public read(): bool

public readInnerXml(): string

public readOuterXml(): string

public readString(): string

public setParserProperty(int $property, bool $value): bool

public setRelaxNGSchema(?string $filename): bool

public setRelaxNGSchemaSource(?string $source): bool

public setSchema(?string $filename): bool

public static XML(string $source, ?string $encoding = null, int $flags = 0): bool|XMLReader

}

Eigenschaften

attributeCount: Die Anzahl der Attribute des aktuellen Knotens
baseURI: Der Basis-URI des Knotens
depth: Die Tiefe des Knotens im Baum, beginnend mit 0
hasAttributes: Zeigt an, ob der Knoten Attribute besitzt
hasValue: Zeigt an, ob der Knoten einen Text-Wert besitzt
isDefault: Zeigt an, ob das Attribute als Standard aus der DTD übernommen wurde
isEmptyElement: Zeigt an, ob der Knoten ein leeres Element-Tag ist
localName: Der lokale Name des Knotens
name: Der qualifizierte Name des Knotens
namespaceURI: Der URI des Namensraums, welcher mit dem Knoten assoziiert ist
nodeType: Der Typ des Knotens
prefix: Das Präfix, welches mit dem Namespaces des Knotens assoziiert wird
value: Der Text-Wert des Knotens
xmlLang: Der xml:lang-Bereich, in dem sich der Knoten befindet

Vordefinierte Konstanten

XMLReader-Knoten-Typen

XMLReader::NONE: Kein Typ
XMLReader::ELEMENT: Start-Element
XMLReader::ATTRIBUTE: Attribut-Knoten
XMLReader::TEXT: Text-Knoten
XMLReader::CDATA: CDATA-Knoten
XMLReader::ENTITY_REF: Entitätsreferenz-Knoten
XMLReader::ENTITY: Entitätsdeklarations-Knoten
XMLReader::PI: Verarbeitungsanweisungs-Knoten
XMLReader::COMMENT: Kommentar-Knoten
XMLReader::DOC: Dokument-Knoten
XMLReader::DOC_TYPE: Dokumenttyp-Knoten
XMLReader::DOC_FRAGMENT: Dokumentfragment-Knoten
XMLReader::NOTATION: Notationsknoten
XMLReader::WHITESPACE: Whitespace-Knoten
XMLReader::SIGNIFICANT_WHITESPACE: Significant-Whitespace-Knoten
XMLReader::END_ELEMENT: Schließendes Element
XMLReader::END_ENTITY: Entitätsende
XMLReader::XML_DECLARATION: XML-Deklarations-Knoten

XMLReader-Parser-Optionen

XMLReader::LOADDTD: DTD laden, aber nicht validieren
XMLReader::DEFAULTATTRS: DTD und Standardattribute laden, aber nicht validieren
XMLReader::VALIDATE: DTD laden und beim Parsen validieren
XMLReader::SUBST_ENTITIES: Entitäten ersetzen und Referenzen erweitern

Inhaltsverzeichnis

XMLReader::close — XMLReader-Eingabe beenden
XMLReader::expand — Gibt eine Kopie des aktuellen Knotens als DOM-Objekt zurück
XMLReader::getAttribute — Liefert den Wert eines Attributes nach Namen
XMLReader::getAttributeNo — Gibt den Wert eines Attributes nach Position zurück
XMLReader::getAttributeNs — Gibt den Wert eines Attributes nach lokalem Namen und URI zurück
XMLReader::getParserProperty — Zeigt an, ob die angegebene Eigenschaft gesetzt wurde
XMLReader::isValid — Zeigt an, ob das geparste Dokument valide ist
XMLReader::lookupNamespace — Prüft, ob ein Namensbereich für einen Präfix vorhanden ist
XMLReader::moveToAttribute — Zeiger auf benanntes Attribut setzen
XMLReader::moveToAttributeNo — Move cursor to an attribute by index
XMLReader::moveToAttributeNs — Move cursor to a named attribute
XMLReader->moveToElement — Zeiger positionieren auf das Elternelement des aktuellen Attributes
XMLReader::moveToFirstAttribute — Zeiger auf erstes Attribut setzen
XMLReader::moveToNextAttribute — Zeiger auf nächstes Attribut setzen
XMLReader::next — Zeiger auf nächstes Element setzen und Kinder überspringen
XMLReader::open — URI angeben, die auf XML-Inhalt verweist, der geparst werden soll
XMLReader::read — Zeiger auf das nächste Element setzen
XMLReader::readInnerXml — Erhalte XML des aktuellen Knotens
XMLReader::readOuterXml — Liest XML des aktuellen Knotens, inklusive den Knoten selbst
XMLReader::readString — Liest den Inhalt des aktuellen Knotens als Zeichenkette
XMLReader::setParserProperty — Parser-Optionen setzen
XMLReader::setRelaxNGSchema — Dateiname oder URI des RelaxNG-Schema setzen
XMLReader::setRelaxNGSchemaSource — Zeichenkette setzen, die RelaxNG-Schemadaten enthält
XMLReader::setSchema — Validiert Dokument gegen XSD
XMLReader::XML — Zeichenkette setzen, deren Inhalt geparst werden soll