DOMDOCUMENT.CREATEELEMENT(3) 1 DOMDOCUMENT.CREATEELEMENT(3)
DOMDocument::createElement - Create new element node
SYNOPSIS
public DOMElement DOMDocument::createElement (string $name, [string $value])
DESCRIPTION
This function creates a new instance of class DOMElement. This node will not show up in the document unless it is inserted with (e.g.)
DOMNode.appendChild(3).
PARAMETERS
o $name
- The tag name of the element.
o $value
- The value of the element. By default, an empty element will be created. The value can also be set later with DOMElement::$node-
Value.
RETURN VALUES
Returns a new instance of class DOMElement or FALSE if an error occurred.
ERRORS
/EXCEPTIONS
o DOM_INVALID_CHARACTER_ERR - Raised if $name contains an invalid character.
EXAMPLES
Example #1
Creating a new element and inserting it as root
<?php
$dom = new DOMDocument('1.0', 'utf-8');
$element = $dom->createElement('test', 'This is the root element!');
// We insert the new element as root (child of the document)
$dom->appendChild($element);
echo $dom->saveXML();
?>
The above example will output:
<?xml version="1.0" encoding="utf-8"?>
<test>This is the root element!</test>
NOTES
Note
The $value will not be escaped. Use DOMDocument::createTextNode to create a text node with escaping support.
SEE ALSO
DOMNode::appendChild, DOMDocument::createAttribute, DOMDocument::createAttributeNS, DOMDocument::createCDATASection, DOMDocument::create-
Comment, DOMDocument::createDocumentFragment, DOMDocument::createElementNS, DOMDocument::createEntityReference, DOMDocument::createPro-
cessingInstruction, DOMDocument::createTextNode.
PHP Documentation Group DOMDOCUMENT.CREATEELEMENT(3)
