La clase XMLReader

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

Introducción

La extensión XMLReader es un analizador XML. El analizador funciona como un cursor que recorre el documento y se detiene en cada nodo.

Sinopsis de la Clase

class XMLReader {

/* Constantes */

public const int NONE;

public const int ELEMENT;

public const int ATTRIBUTE;

public const int TEXT;

public const int CDATA;

public const int ENTITY_REF;

public const int ENTITY;

public const int PI;

public const int COMMENT;

public const int DOC;

public const int DOC_TYPE;

public const int DOC_FRAGMENT;

public const int NOTATION;

public const int WHITESPACE;

public const int SIGNIFICANT_WHITESPACE;

public const int END_ELEMENT;

public const int END_ENTITY;

public const int XML_DECLARATION;

public const int LOADDTD;

public const int DEFAULTATTRS;

public const int VALIDATE;

public const int SUBST_ENTITIES;

/* Propiedades */

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;

/* Métodos */

public close(): true

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

public static fromStream(
    resource $stream,
    ?string $encoding = null,
    int $flags = 0,
    ?string $documentUri = null
): static

public static fromString(string $source, ?string $encoding = null, int $flags = 0): static

public static fromUri(string $uri, ?string $encoding = null, int $flags = 0): static

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): XMLReader

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

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): XMLReader

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

}

Propiedades

attributeCount: El número de atributos en el nodo
baseURI: La URI base del nodo
depth: Profundidad del nodo en el árbol comenzando en 0
hasAttributes: Indica si el nodo tiene atributos
hasValue: Indica si el nodo tiene un valor de texto
isDefault: Indica si el atributo es por defecto desde el DTD
isEmptyElement: Indica si el nodo es un elemento vacío
localName: El nombre local del nodo
name: El nombre calificado del nodo
namespaceURI: El URI del espacio de nombres asociado con el nodo
nodeType: El tipo de nodo para el nodo
prefix: El prefijo del espacio de nombres asociado con el nodo
value: El valor de texto del nodo
xmlLang: El ámbito xml:lang en el que reside el nodo

Constantes predefinidas

Tipos de nodo XMLReader

XMLReader::NONE: Ningún tipo de nodo
XMLReader::ELEMENT: Elemento de inicio
XMLReader::ATTRIBUTE: Nodo Atributo
XMLReader::TEXT: Nodo texto
XMLReader::CDATA: Nodo CDATA
XMLReader::ENTITY_REF: Nodo de referencia de entidad
XMLReader::ENTITY: Nodo de declaración de entidad
XMLReader::PI: Nodo de instrucción de proceso
XMLReader::COMMENT: Nodo de comentario
XMLReader::DOC: Nodo documento
XMLReader::DOC_TYPE: Nodo de tipo de documento
XMLReader::DOC_FRAGMENT: Nodo de fragmento de documento
XMLReader::NOTATION: Nodo de notación
XMLReader::WHITESPACE: Nodo "espacio"
XMLReader::SIGNIFICANT_WHITESPACE: Nodo "espacio" significativo
XMLReader::END_ELEMENT: Elemento de fin
XMLReader::END_ENTITY: Entidad de fin
XMLReader::XML_DECLARATION: Nodo de declaración XML

Opciones del analizador XMLReader

XMLReader::LOADDTD: Carga un DTD pero no lo valida
XMLReader::DEFAULTATTRS: Carga un DTD y los atributos por defecto pero no lo valida
XMLReader::VALIDATE: Carga un DTD y valida el documento durante el análisis
XMLReader::SUBST_ENTITIES: Sustituye las entidades y expande las referencias

Historial de cambios

Versión	Descripción
8.4.0	Las constantes de clase ahora están tipadas.

Tabla de contenidos

XMLReader::close — Cierra la entrada del XMLReader
XMLReader::expand — Devuelve una copia del nodo actual como un nodo de objeto DOM
XMLReader::fromStream — Crear un XMLReader a partir de un flujo para leer
XMLReader::fromString — Crear un XMLReader a partir de una cadena XML
XMLReader::fromUri — Crear un XMLReader a partir de una URI para leer
XMLReader::getAttribute — Obtiener el valor del atributo nombrado
XMLReader::getAttributeNo — Obtiene el valor de un atributo por el indice
XMLReader::getAttributeNs — Recupera el valor de un atributo por nombre local y URI
XMLReader::getParserProperty — Indica si la porpiedad especificada ha sido establecida
XMLReader::isValid — Indica si el documento analizado es válido
XMLReader::lookupNamespace — Consulta el espacio de nombres para un prefijo
XMLReader::moveToAttribute — Mueve el cursor a un atributo nombrado
XMLReader::moveToAttributeNo — Mueve el cursor a un atributo por su índice
XMLReader::moveToAttributeNs — Mover el cursor a un atributo dado
XMLReader::moveToElement — Posiciona el cursor en el eleménto padre del actual atributo
XMLReader::moveToFirstAttribute — Posiciona el cursor en el primer atributo
XMLReader::moveToNextAttribute — Posiciona el cursor en el siguiente atributo
XMLReader::next — Mueve el cursor al siguiente nodo saltandose todos los subárboles
XMLReader::open — Fija el URI que contiene el XML a analizar
XMLReader::read — Se mueve al siguiente nodo en el documento
XMLReader::readInnerXml — Recupera el XML del actual nodo
XMLReader::readOuterXml — Recupera el XML del actual nodo, incluyendo él mismo
XMLReader::readString — Lee el contenido del nodo actual como string
XMLReader::setParserProperty — Establecer las opciones del analizador
XMLReader::setRelaxNGSchema — Establece el nomb re del archivo o el URI para un esquema RelaxNG
XMLReader::setRelaxNGSchemaSource — Establece los datos contenidos en un esquema RelaxNG
XMLReader::setSchema — Valida el documento en contra del XSD
XMLReader::XML — Establece los datos que contienen el XML a analizar