DOMDocument::createElement
DOMDocument::createElement
(PHP 5, PHP 7)
DOMDocument :: createElement - 创建新的元素节点
描述
public DOMElement DOMDocument::createElement ( string $name [, string $value ] )
这个函数创建一个DOMElement类的新实例。除非使用(例如)DOMNode :: appendChild()插入,否则该节点不会显示在文档中。
参数
name
元素的标签名称。
value
元素的值。默认情况下,将创建一个空元素。该值也可以稍后用DOMElement :: $ nodeValue进行设置。
该值是逐字使用的,只是<和>实体引用会被转义。请注意&必须手动转义; 否则视为启动实体引用。也“不会逃脱。
返回值
返回类DOMElement的新实例或发生错误时返回FALSE
。
错误/异常
DOM_INVALID_CHARACTER_ERR
如果name
包含无效字符则引发。
例子
示例#1创建一个新元素并将其作为根插入
<?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>
示例#2传递包含非转义&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/>
笔记
注
: