Введение

The DOM extension allows you to operate on XML documents through the DOM API with PHP 5.

For PHP 4, use DOM XML.

Замечание: DOM extension uses UTF-8 encoding. Use utf8_encode() and utf8_decode() to work with texts in ISO-8859-1 encoding or Iconv for other encodings.

Установка

Для использования этих функций не требуется проведение установки, поскольку они являются частью ядра PHP.

Предопределенные классы

The API of the module follows the » DOM Level 3 standard as closely as possible. Consequently, the API is fully object-oriented. It is a good idea to have the DOM standard available when using this module.

This module defines a number of classes, which are explained in the following tables. Classes with an equivalent in the DOM standard are named DOMxxx.

Примеры

Many examples in this reference require an XML file. We will use book.xml that contains the following:

Предопределенные константы

Перечисленные ниже константы определены данным расширением и могут быть доступны только в том случае, если PHP был собран с поддержкой этого расширения или же в том случае, если данное расширение подгружается во время выполнения.

Содержание

DOMAttr->__construct() — Creates a new DOMAttr object

DOMAttr->isId() — Checks if attribute is a defined ID

DOMCharacterData->appendData() — Append the string to the end of the character data of the node

DOMCharacterData->deleteData() — Remove a range of characters from the node

DOMCharacterData->insertData() — Insert a string at the specified 16-bit unit offset

DOMCharacterData->replaceData() — Replace a substring within the DOMCharacterData node

DOMCharacterData->substringData() — Extracts a range of data from the node

DOMComment->__construct() — Creates a new DOMComment object

DOMDocument->__construct() — Creates a new DOMDocument object

DOMDocument->createAttribute() — Create new attribute

DOMDocument->createAttributeNS() — Create new attribute node with an associated namespace

DOMDocument->createCDATASection() — Create new cdata node

DOMDocument->createComment() — Create new comment node

DOMDocument->createDocumentFragment() — Create new document fragment

DOMDocument->createElement() — Create new element node

DOMDocument->createElementNS() — Create new element node with an associated namespace

DOMDocument->createEntityReference() — Create new entity reference node

DOMDocument->createProcessingInstruction() — Creates new PI node

DOMDocument->createTextNode() — Create new text node

DOMDocument->getElementById() — Searches for an element with a certain id

DOMDocument->getElementsByTagName() — Searches for all elements with given tag name

DOMDocument->getElementsByTagNameNS() — Searches for all elements with given tag name in specified namespace

DOMDocument->importNode() — Import node into current document

DOMDocument->load() — Load XML from a file

DOMDocument->loadHTML() — Load HTML from a string

DOMDocument->loadHTMLFile() — Load HTML from a file

DOMDocument->loadXML() — Load XML from a string

DOMDocument->normalizeDocument() — Normalizes the document

DOMDocument->registerNodeClass() — Register extended class used to create base node type

DOMDocument->relaxNGValidate() — Performs relaxNG validation on the document

DOMDocument->relaxNGValidateSource() — Performs relaxNG validation on the document

DOMDocument->save() — Dumps the internal XML tree back into a file

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() — Validates the document based on its DTD

DOMDocument->xinclude() — Substitutes XIncludes in a DOMDocument Object

DOMDocumentFragment->appendXML() — Append raw XML data

DOMElement->__construct() — Creates a new DOMElement object

DOMElement->getAttribute() — Returns value of attribute

DOMElement->getAttributeNode() — Returns attribute node

DOMElement->getAttributeNodeNS() — Returns attribute node

DOMElement->getAttributeNS() — Returns value of attribute

DOMElement->getElementsByTagName() — Gets elements by tagname

DOMElement->getElementsByTagNameNS() — Get elements by namespaceURI and localName

DOMElement->hasAttribute() — Checks to see if attribute exists

DOMElement->hasAttributeNS() — Checks to see if attribute exists

DOMElement->removeAttribute() — Removes attribute

DOMElement->removeAttributeNode() — Removes attribute

DOMElement->removeAttributeNS() — Removes attribute

DOMElement->setAttribute() — Adds new attribute

DOMElement->setAttributeNode() — Adds new attribute node to element

DOMElement->setAttributeNodeNS() — Adds new attribute node to element

DOMElement->setAttributeNS() — Adds new attribute

DOMElement->setIdAttribute() — Declares the attribute specified by name to be of type ID

DOMElement->setIdAttributeNode() — Declares the attribute specified by node to be of type ID

DOMElement->setIdAttributeNS() — Declares the attribute specified by local name and namespace URI to be of type ID

DOMEntityReference->__construct() — Creates a new DOMEntityReference object

DOMImplementation->__construct() — Creates a new DOMImplementation object

DOMImplementation->createDocument() — Creates a DOMDocument object of the specified type with its document element

DOMImplementation->createDocumentType() — Creates an empty DOMDocumentType object

DOMImplementation->hasFeature() — Test if the DOM implementation implements a specific feature

DOMNamedNodeMap->getNamedItem() — Retrieves a node specified by name

DOMNamedNodeMap->getNamedItemNS() — Retrieves a node specified by local name and namespace URI

DOMNamedNodeMap->item() — Retrieves a node specified by index

DOMNode->appendChild() — Adds new child at the end of the children

DOMNode->cloneNode() — Clones a node

DOMNode->hasAttributes() — Checks if node has attributes

DOMNode->hasChildNodes() — Checks if node has children

DOMNode->insertBefore() — Adds a new child before a reference node

DOMNode->isDefaultNamespace() — Checks if the specified namespaceURI is the default namespace or not

DOMNode->isSameNode() — Indicates if two nodes are the same node

DOMNode->isSupported() — Checks if feature is supported for specified version

DOMNode->lookupNamespaceURI() — Gets the namespace URI of the node based on the prefix

DOMNode->lookupPrefix() — Gets the namespace prefix of the node based on the namespace URI

DOMNode->normalize() — Normalizes the node

DOMNode->removeChild() — Removes child from list of children

DOMNode->replaceChild() — Replaces a child

DOMNodelist->item() — Retrieves a node specified by index

DOMProcessingInstruction->__construct() — Creates a new DOMProcessingInstruction object

DOMText->__construct() — Creates a new DOMText object

DOMText->isWhitespaceInElementContent() — Indicates whether this text node contains whitespace

DOMText->splitText() — Breaks this node into two nodes at the specified offset

DOMXPath->__construct() — Creates a new DOMXPath object

DOMXPath->evaluate() — Evaluates the given XPath expression and returns a typed result if possible.

DOMXPath->query() — Evaluates the given XPath expression

DOMXPath->registerNamespace() — Registers the namespace with the DOMXPath object

dom_import_simplexml — Gets a DOMElement object from a SimpleXMLElement object