(PHP 5, PHP 7)
DOMDocument::createElement — Create new element node
This function creates a new instance of class DOMElement. Dieser Knoten wird in Ihrem Dokument nicht sichtbar sein, bis dieser zum Beispiel mit der Funktion DOMNode::appendChild eingefügt wird.
nameThe tag name of the element.
valueThe value of the element. By default, an empty element will be created. The value can also be set later with DOMElement::$nodeValue.
The value is used verbatim except that the < and > entity references will escaped. Note that & has to be manually escaped; otherwise it is regarded as starting an entity reference. Also " won't be escaped.
Returns a new instance of class DOMElement or FALSE
if an error occurred.
DOM_INVALID_CHARACTER_ERR
Raised if name contains an invalid character.
Beispiel #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();
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
<?xml version="1.0" encoding="utf-8"?> <test>This is the root element!</test>
Beispiel #2 Passing text containing an unescaped & as value
<?php
$dom = new DOMDocument('1.0', 'utf-8');
$element = $dom->createElement('foo', 'me & you');
$dom->appendChild($element);
echo $dom->saveXML();
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Warning: DOMDocument::createElement(): unterminated entity reference you in /in/BjTCg on line 4 <?xml version="1.0" encoding="utf-8"?> <foo/>
Hinweis:
The
valuewill not be escaped. Use DOMDocument::createTextNode() to create a text node with escaping support.