DOMDocument::createElement

(PHP 5, PHP 7)

DOMDocument::createElement — Create new element node

说锟斤拷

public DOMDocument::createElement ( string $name [, string $value ] ) : DOMElement

This function creates a new instance of class DOMElement. 锟剿节碉拷锟斤拷锟斤拷锟斤拷牡锟斤拷校锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟� DOMNode->appendChild() 锟饺猴拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷搿�

锟斤拷锟斤拷

name

The tag name of the element.

value

The 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.

锟斤拷锟斤拷

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();
?>

锟斤拷锟斤拷锟斤拷锟教伙拷锟斤拷锟斤拷锟�

<?xml version="1.0" encoding="utf-8"?>
<test>This is the root element!</test>

Example #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();
?>

锟斤拷锟斤拷锟斤拷锟教碉拷锟斤拷锟斤拷锟斤拷锟斤拷冢锟�

Warning: DOMDocument::createElement(): unterminated entity reference             you in /in/BjTCg on line 4
<?xml version="1.0" encoding="utf-8"?>
<foo/>

注锟斤拷

Note:

The value will not be escaped. Use DOMDocument::createTextNode() to create a text node with escaping support.

锟轿硷拷