XXVII. Funzioni DOM

Introduzione

L'estensione DOM è il sostituto del modulo DOM XML di PHP 4. Questo modulo contiente diverse vecchie funzioni, ma non dovrebbero essere più utilizzate. In particolare, si dovrebbe evitare le funzioni che non siano orientate agli oggetti.

Questa estensione permette di lavorare su un documento XML con le API DOM.

Costanti predefinite

Queste costanti sono definite da questa estensione e sono disponibili solo se l'estensione è stata compilata nel PHP o se è stata caricata dinamicamente a runtime.

Tabella 1. Costanti XML

CostanteValoreDescrizione
XML_ELEMENT_NODE (integer) 1Il nodo è un elemento
XML_ATTRIBUTE_NODE (integer) 2Il nodo è un attributo
XML_TEXT_NODE (integer) 3Il nodo è un testo
XML_CDATA_SECTION_NODE (integer) 4 
XML_ENTITY_REF_NODE (integer) 5 
XML_ENTITY_NODE (integer) 6Il nodo è un entità tipo  
XML_PI_NODE (integer) 7Il nodo è un istruzione di processamento
XML_COMMENT_NODE (integer) 8Il nodo è un commento
XML_DOCUMENT_NODE (integer) 9Il nodo è un documento
XML_DOCUMENT_TYPE_NODE (integer) 10 
XML_DOCUMENT_FRAG_NODE (integer) 11 
XML_NOTATION_NODE (integer) 12 
XML_HTML_DOCUMENT_NODE (integer) 13 
XML_DTD_NODE (integer) 14 
XML_ELEMENT_DECL_NODE (integer) 15 
XML_ATTRIBUTE_DECL_NODE (integer) 16 
XML_ENTITY_DECL_NODE (integer) 17 
XML_NAMESPACE_DECL_NODE (integer) 18 
XML_ATTRIBUTE_CDATA (integer) 1 
XML_ATTRIBUTE_ID (integer) 2 
XML_ATTRIBUTE_IDREF (integer) 3 
XML_ATTRIBUTE_IDREFS (integer) 4 
XML_ATTRIBUTE_ENTITY (integer) 5 
XML_ATTRIBUTE_NMTOKEN (integer) 7 
XML_ATTRIBUTE_NMTOKENS (integer) 8 
XML_ATTRIBUTE_ENUMERATION (integer) 9 
XML_ATTRIBUTE_NOTATION (integer) 10 

Tabella 2. Costanti DOMException

CostanteValoreDescrizione
DOM_INDEX_SIZE_ERR (integer) 1 
DOMSTRING_SIZE_ERR (integer) 2 
DOM_HIERARCHY_REQUEST_ERR (integer) 3 
DOM_WRONG_DOCUMENT_ERR (integer) 4 
DOM_INVALID_CHARACTER_ERR (integer) 5 
DOM_NO_DATA_ALLOWED_ERR (integer) 6 
DOM_NO_MODIFICATION_ALLOWED_ERR (integer) 7 
DOM_NOT_FOUND_ERR (integer) 8 
DOM_NOT_SUPPORTED_ERR (integer) 9 
DOM_INUSE_ATTRIBUTE_ERR (integer) 10 
DOM_INVALID_STATE_ERR (integer) 11 
DOM_SYNTAX_ERR (integer) 12 
DOM_INVALID_MODIFICATION_ERR (integer) 13 
DOM_NAMESPACE_ERR (integer) 14 
DOM_INVALID_ACCESS_ERR (integer) 15 
DOM_VALIDATION_ERR (integer) 16 

Classes

Le API del modulo seguono molto da vicino lo standard DOM di livello 2. Di conseguenza, le API sono completamente orientate agli oggetti. E' oppportuno avere a disposizione lo standard DOM quando si utilizza questo modulo.

Questo modulo implementa diverse classi, che saranno elencate - compresi i loro metodi - nelle seguenti tabelle. La classi con un equivalente nello standard DOM sono chiamate DOMxxx.

Tabella 3. Elenco delle classi

Nome della classeClasse genitore
DOMAttrDOMNode
DOMCDataSectionDOMText : DOMNode
DOMCharacterDataDOMNode
DOMCommentDOMCharacterData : DomNode
DOMDocumentDOMNode
DOMDocumentFragmentDOMNode
DOMDocumentTypeDOMNode
DOMElementDOMNode
DOMEntityDOMNode
DOMEntityReferenceDOMNode
DOMNode 
DOMNotationDOMNode
DOMProcessingInstructionDOMNode
DOMTextDOMCDataSection : DomNode
DOMException 
DOMImplementation 
DOMNamedNodeMap 
DOMNodeList 
DOMXPath 

Sommario
DOMAttr->isId --  Verifica se un attributo è un ID definito
DOMCharacterData->appendData --  Aggiunge un testo alla fine dei dati di un nodo
DOMCharacterData->deleteData --  Rimuove un range di caratteri da un nodo
DOMCharacterData->insertData --  Inserisce una stringa all'offset indicato
DOMCharacterData->replaceData --  Sostituisce una stringa all'interno di un nodo DOMCharacterData
DOMCharacterData->substringData --  Estrae un range di dati da un nodo
DOMDocument->__construct() --  Creates a new DOMDocument object
DOMDocument->createAttribute -- Crea un nuovo attributo
DOMDocument->createAttributeNS --  Crea un nuovo nodo attributo all'interno dello spazio dei nomi associato
DOMDocument->createCDATASection -- Crea un nodo cdata
DOMDocument->createComment -- Crea un nuovo nodo di commento
DOMDocument->createDocumentFragment -- Crea un nuovo frammento di documento
DOMDocument->createElement -- Crea un nuovo nodo elemento
DOMDocument->createElementNS --  Crea un nuovo nodo elemento nello spazio dei nomi associato
DOMDocument->createEntityReference -- Crea un nuovo nodo entità
DOMDocument->createProcessingInstruction -- Crea un nuovo nodo PI
DOMDocument->createTextNode -- Crea un nuovo nodo di testo
DOMDocument->getElementById -- Ricerca di un elemento per un dato id
DOMDocument->getElementsByTagName -- Cerca tra tutti gli elementi il tag dato
DOMDocument->getElementsByTagNameNS --  Ricerca tra tutti gli elementi di un tag nello spazio dei nomi indicato
DOMDocument->importNode -- Importa un nodo nel documento corrente
DOMDocument->load --  Carica XML da un file
DOMDocument->loadHTML --  Carica HTML da una stringa
DOMDocument->loadHTMLFile --  Carica HTML da file
DOMDocument->loadXML --  Carica XML da una stringa
DOMDocument->normalize --  Normalizza il documento
DOMDocument->relaxNGValidate --  Esegue una validazione relaxNG sul documento
DOMDocument->relaxNGValidateSource --  Esegue una validazione relaxNG sul documento
DOMDocument->save --  Scarica in un file l'albero XML interno
DOMDocument->saveHTML() --  Dumps the internal document into a string using HTML formatting
DOMDocument->saveHTMLFile() --  Dumps the internal document into a file using HTML formatting
DOMDocument->saveXML() --  Dumps the internal XML tree back into a string
DOMDocument->schemaValidate() --  Validates a document based on a schema
DOMDocument->schemaValidateSource() --  Validates a document based on a schema
DOMDocument->validate --  Valida il documento in base al suo DTD
DOMDocument->xinclude --  Sostituisce gli XIncludes in un oggetto DOMDocument
DOMElement->getAttribute -- Restituisce il valore di un attributo
DOMElement->getAttributeNode -- Restituisce il nodo attributo
DOMElement->getAttributeNodeNS --  Restituisce un nodo attributo
DOMElement->getAttributeNS -- Restituisce il valore di un attributo
DOMElement->getElementsByTagName -- Restituisce gli elementi in base al nome del tag
DOMElement->getElementsByTagNameNS -- Restituisce gli elementi per spazio dei nomi e nome locale
DOMElement->hasAttribute -- Verifica se l'attributo esiste
DOMElement->hasAttributeNS --  Verifica se esiste l'attributo
DOMElement->removeAttribute -- Rimuove l'attributo
DOMElement->removeAttributeNode -- Rimuove gli attributi
DOMElement->removeAttributeNS -- Rimuove gli attributi
DOMElement->setAttribute -- Aggiunge un nuovo attributo
DOMElement->setAttributeNode -- Aggiunge un nuovo nodo attributo all'elemento
DOMElement->setAttributeNodeNS -- Aggiunge un nuovo nodo attributo all'elemento
DOMElement->setAttributeNS -- Aggiunge un nuovo attributo
DOMImplementation->createDocument --  Crea un oggetto DOMDocument del tipo indicato con il suo elemento documento
DOMImplementation->createDocumentType --  Crea un oggetto DOMDocumentType vuoto
DOMImplementation->hasFeature --  Verifica se l'implementazione DOM ha una specifica caratteristica e versione
DOMNamedNodeMap->getNamedItem --  Recupera un nodo indicando il nome
DOMNamedNodeMap->getNamedItemNS --  Recupera un nodo indicando il nome locale e l'URI dello spazio dei nomi
DOMNamedNodeMap->item -- Recupera un nodo tramite il suo indice
DOMNode->appendChild --  Aggiunge un nuovo nodo figlio alla fine dei nodi figli
DOMNode->cloneNode --  Clona un nodo
DOMNode->hasAttributes --  Verifica se un nodo ha degli attributi
DOMNode->hasChildNodes --  Verifica se un nodo ha nodi figli
DOMNode->insertBefore --  Aggiunge un nuovo nodo figlio alla fine dei nodi figli
DOMNode->isSameNode --  Indica se due nodi sono il medesimo nodo
DOMNode->isSupported --  Verifica se una caratteristica è supportata dalla versione indicata
DOMNode->lookupNamespaceURI --  Restituisce l'URI dello spazio dei nomi in base al prefisso
DOMNode->lookupPrefix --  Resituisce il prefisso dello spazio dei nomi in base all'URI dello spazio dei nomi
DOMNode->normalize --  Normalizza un nodo
DOMNode->removeChild --  Rimuove un nodo figlio dalla lista dei nodi figli
DOMNode->replaceChild --  Sostituisce un nodo figlio Replaces a child
DOMNodelist->item --  Recupera il nodo indicato dall'indice
DOMText->isWhitespaceInElementContent --  Indica se questo nodo di testo contiene spazi
DOMText->splitText --  Spezza il nodo in due all'offset specificato
DOMXPath->__construct() --  Creates a new DOMXPath object
DOMXPath->evaluate() --  Evaluates the given XPath expression and returns a typed result if possible.
DOMXPath->query --  Valuta l'espressione XPath nella stringa data
DOMXPath->registerNamespace --  Registra lo spazio dei nomi nell'oggetto DOMXpath
dom_import_SimpleXML --  Ottiene un'oggetto DOMElement da un'oggetto SimpleXMLElement

Hosting by: hurra.com
Generated: 2007-01-26 17:56:52