SimpleXMLElement::addChild

(PHP 5 >= 5.1.3, PHP 7, PHP 8)

SimpleXMLElement::addChild — 向 XML 节点添加子元素

描述

public SimpleXMLElement::addChild(string $qualifiedName, ?string $value = null, ?string $namespace = null): ?SimpleXMLElement

向节点添加子元素，并返回子元素的 SimpleXMLElement。

参数

qualifiedName: 要添加的子元素的名称。
value: 如果指定，则为子元素的值。
namespace: 如果指定，则为子元素所属的命名空间。

返回值

addChild 方法在成功时返回一个表示添加到 XML 节点的子元素的 SimpleXMLElement 对象；失败时返回 null。

示例

注意:
列出的示例可能包含 example.php，它指的是在基本用法指南的第一个示例中找到的 XML 字符串。

示例 #1 向 SimpleXML 元素添加属性和子元素

<?php

include 'example.php';

$sxe = new SimpleXMLElement($xmlstr);
$sxe->addAttribute('type', 'documentary');

$movie = $sxe->addChild('movie');
$movie->addChild('title', 'PHP2: More Parser Stories');
$movie->addChild('plot', 'This is all about the people who make it work.');

$characters = $movie->addChild('characters');
$character = $characters->addChild('character');
$character->addChild('name', 'Mr. Parser');
$character->addChild('actor', 'John Doe');

$rating = $movie->addChild('rating', '5');
$rating->addAttribute('type', 'stars');
 
echo $sxe->asXML();

?>

上面的示例将输出类似于以下内容

<?xml version="1.0" standalone="yes"?>
<movies type="documentary">
 <movie>
  <title>PHP: Behind the Parser</title>
  <characters>
   <character>
    <name>Ms. Coder</name>
    <actor>Onlivia Actora</actor>
   </character>
   <character>
    <name>Mr. Coder</name>
    <actor>El Act&#xD3;r</actor>
   </character>
  </characters>
  <plot>
   So, this language. It's like, a programming language. Or is it a
   scripting language? All is revealed in this thrilling horror spoof
   of a documentary.
  </plot>
  <great-lines>
   <line>PHP solves all my web problems</line>
  </great-lines>
  <rating type="thumbs">7</rating>
  <rating type="stars">5</rating>
 </movie>
 <movie>
  <title>PHP2: More Parser Stories</title>
  <plot>This is all about the people who make it work.</plot>
  <characters>
   <character>
    <name>Mr. Parser</name>
    <actor>John Doe</actor>
   </character>
  </characters>
  <rating type="stars">5</rating>
 </movie>
</movies>

参见

SimpleXMLElement::addAttribute() - 向 SimpleXML 元素添加属性
基本 SimpleXML 用法

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 13 个注释

向上

向下

frosty dot z at freesbee dot fr ¶

11 年前

为了补充 Volker Grabsch 的评论，他指出
"注意，虽然 addChild() 转义了 "<" 和 ">"，但它没有转义 "&"。

为了解决这个问题，您可以使用直接属性赋值，例如

<?php
$xmlelement->value = 'my value < > &';
// 结果为 <value>my value &lt; &gt; &amp;</value>
?>

而不是

<?php
$xmlelement->addChild('value', 'my value < > &');
// 结果为 <value>my value &lt; &gt; &</value>（无效的 XML）
?>

另请参见：http://stackoverflow.com/questions/552957（SimpleXMLElement 处理 addChild 和 addAttribute 中文本值的原理）

希望对您有所帮助

向上

向下

alex dot feraud at gmail dot com ¶

13 年前

以下是一个包含更多 SimpleXMLElement 功能的类


<?php 
/** 
 * 
 * SimpleXMLElement 扩展 
 * @author Alexandre FERAUD 
 * 
 */ 
class ExSimpleXMLElement extends SimpleXMLElement 
{ 
 /** 
 * 在节点中添加 CDATA 文本 
 * @param string $cdata_text 要添加的 CDATA 值 
 */ 
 private function addCData($cdata_text) 
 { 
 $node= dom_import_simplexml($this); 
 $no = $node->ownerDocument; 
 $node->appendChild($no->createCDATASection($cdata_text)); 
 } 
 
 /** 
 * 创建一个具有 CDATA 值的子节点 
 * @param string $name 要添加的子元素名称。 
 * @param string $cdata_text 子元素的 CDATA 值。 
 */ 
 public function addChildCData($name,$cdata_text) 
 { 
 $child = $this->addChild($name); 
 $child->addCData($cdata_text); 
 } 
 
 /** 
 * 将 SimpleXMLElement 代码添加到 SimpleXMLElement 中 
 * @param SimpleXMLElement $append 
 */ 
 public function appendXML($append) 
 { 
 if ($append) { 
 if (strlen(trim((string) $append))==0) { 
 $xml = $this->addChild($append->getName()); 
 foreach($append->children() as $child) { 
 $xml->appendXML($child); 
 } 
 } else { 
 $xml = $this->addChild($append->getName(), (string) $append); 
 } 
 foreach($append->attributes() as $n => $v) { 
 $xml->addAttribute($n, $v); 
 } 
 } 
 } 
} 
?>

向上

向下

johninen at gmail dot com ¶

8 年前

在 Google 网站地图的文档中，需要一个用于移动网站地图的元素，如下所示：<mobile:mobile/>

我花了一些时间来弄清楚如何制作它，但一旦理解了，就相当简单。

$mobile_schema = 'http://www.google.com/schemas/sitemap-mobile/1.0';

// 创建根元素
$xml_mobile = new SimpleXMLElement('
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:mobile="'.$mobile_schema.'"></urlset>
');

// 添加必需的子节点
$url_mobile = $xml_b_list_mobile->addChild('url');
$url_mobile->addChild('loc', 'your-mobile-site-url');
$url_mobile->addChild('mobile:mobile', null, $mobile_schema);

为了使这正常工作，必须在根节点中设置属性 xmlns:mobile，然后在创建具有 null 值的 mobile:mobile 子节点时将其用作命名空间（第三个参数）。

向上

向下

nwarap ¶

6 年前

想继续讨论 & 符号链问题。

有时，你可能想要将 (=) 赋值给 addChild。
这个技巧可以帮助你实现这一点。

<?php
$webOrders = new SimpleXMLElement('<?xml version="1.0"?><WebOrders></WebOrders>');
$webOrder = $webOrders->addChild('WebOrder');
$product = $webOrder->addChild('Product');
$product[0] = 'T&M';
$product->addAttribute('price', 19.99);
$product->addAttribute('qty', 2);
var_dump($webOrders->asXML());
?>

输出结果为

<?xml version="1.0" encoding="UTF-8"?>
<WebOrders>
<WebOrder>
<Product price="19.99" qty="2">T&amp;M</Product>
</WebOrder>
</WebOrders>

向上

向下

Volker Grabsch ¶

13 年前

请注意，尽管 addChild() 会转义 "<" 和 ">"，但它不会转义 & 符号。

因此，addChild() 不适合处理用户定义的输入！

相反，你必须在调用 addChild() 之前将所有 & 符号替换为 &amp;。

或者，使用 htmlspecialchars()，它也会替换其他字符，但不会造成任何伤害，因为 addChild() 不会再次替换那些字符。

向上

向下

ivan dot kakurov at gmail dot com ¶

11 年前

这是我用于从多维数组创建 XML 的解决方案。
<?php
// 数据 
 $xmlDAta = array(
 array(
 "name" => "nameVal",
 "value" => "valVal",
 "css" => "cssVal"
 ),
 array(
 "name" => "name1Val",
 "value" => "val1Val",
 "css" => "css1Val"
 ),
 "tname" => array(
 array(
 "iTname" => "iTname",
 "iTname2" => "iTname1",
 "iTname2" => "iTname2",
 "iTbname3" => array(
 "iiTbname" => "tbName",
 "iiTbname1" => "tbName1",
 ),
 ),
 ),
 "tdata" => "otheerDAta"
 );

 /**
 * 使用字符串或数组创建 XML
 *
 * @param mixed $data 输入数据
 * @param SimpleXMLElement $xml
 * @param string $child 一级子节点的名称
 *
 * @return 将 XML 格式化的数据添加到 SimpleXmlElement
 */

function data2XML(array $data, SimpleXMLElement $xml, $child = "items")
 {

 foreach($data as $key => $val) {
 if(is_array($val)) {

 if(is_numeric($key)) {
 $node = $xml->addChild($child);
 $nodes = $node->getName($child);
 } else {

 $node = $xml->addChild($key);
 $nodes = $node->getName($key);
 }

 $node->addChild($nodes, self::data2Xml($val, $node));
 } else {
 $xml->addChild($key, $val);
 }
 }

 }

// 使用 

 $xml = new SimpleXMLElement("<root/>");
 Util::data2XML($xmlDAta, $xml, "Items");

?>

向上

向下

fluxlicious at gmail dot com ¶

1 年前

下面的类允许你写入 CDATA 并添加额外的属性。

<?php
class SimpleXMLElementExtended extends \SimpleXMLElement
{
 public function addChildWithCData($name, $value)
 {
 $child = parent::addChild($name);
 $element = dom_import_simplexml($child);
 $docOwner = $element->ownerDocument;
 $element->appendChild($docOwner->createCDATASection($value));
 return $child;
 }
}
?>

示例
<?php
 $xml = new SimpleXMLElementExtended('<xml></xml>');
 $content = $xml->addChildWithCData('content', 'Title of the page');
 $content->addAttribute('id', 1);
 $content->addAttribute('enabled', 'true');

 // 输出:
 // <xml>
 // <content id="1" enabled="true"><![CDATA[Title of the page]]></content>
 // </xml>
?>

向上

向下

caffeinatedbits ¶

1 年前

以防像我一样，其他人也试图找出删除子元素的方法...

<?php

$xml = <<<EOF
<?xml version="1.0" encoding="utf-8" ?>
<Animals>
 <Dog breed="chihuahua"/>
 <Dog breed="poodle"/>
 <Dog breed="invalid"/>
</Animals>
EOF;

$animals = new SimpleXMLElement($xml);

unset($animals->Dog[2]);

echo $animals->asXML();

// <?xml version="1.0" encoding="utf-8"?>
// <Animals>
// <Dog breed="chihuahua"/>
// <Dog breed="poodle"/>
//         
// </Animals>

?>

注意：你不能在迭代子元素时删除元素，否则会破坏迭代器。示例

<?php

$xml = <<<EOF
<?xml version="1.0" encoding="utf-8" ?>
<Animals>
 <Dog breed="chihuahua"/>
 <Dog breed="poodle"/>
 <Dog breed="invalid"/>
</Animals>
EOF;

$animals = new SimpleXMLElement($xml);

$allowed_breeds = [
 'chihuahua',
 'poodle'
];

try {
 $index = 0;
 foreach ($animals->Dog as $dog) {
 if (!in_array($dog['breed'], $allowed_breeds)) {
 unset($animals->Dog[$index]);
 }
 $index++;
 }
} catch (Throwable $e) {
 echo $e->getMessage();
 // SimpleXMLElement is not properly initialized
}

?>

向上

向下

carlos dot eduardo dot debiasi at gmail dot com ¶

3年前

我创建了这个函数，这样你就可以通过一个数组构建 XML，这允许多个键具有相同的值。
结构必须遵循

[
'key' => 'nameOfTheKey',
'attributes' => ['id' => '1'],
'fields' => [
['key' => 'fieldSamName', 'value' => '1'],
['key' => 'fieldSamName', 'value' => '1'],
['key' => 'fieldSamName', 'value' => '2'],
['key' => 'fieldWithChild', 'fields' => [
['key' => 'car', 'value' => '2'],
['key' => 'human', 'value' => '3'],
        ]],
    ]
];

函数
function toXml(\SimpleXMLElement $node, array $data)
    {
foreach ($data as $key => $value) {
$key = $value['key'];
if (isset($value['value'])) {
$newNode = $node->addChild($key, $value['value']);
if (isset($value['attributes'])) {
foreach ($value['attributes'] as $keyAttr => $valueAttr) {
$newNode->addAttribute($keyAttr, $valueAttr);
                    }
                }
} else {
$newNode = $node->addChild($key);
if (isset($value['attributes'])) {
foreach ($value['attributes'] as $keyAttr => $valueAttr) {
$newNode->addAttribute($keyAttr, $valueAttr);
                    }
                }
            }
if (isset($value['fields'])) {
foreach ($value['fields'] as $keyField => $valueField) {
$this->toXml($newNode, [$keyField => $valueField]);
                }
            }
        }
    }

向上

向下

passerbyxp at gmail dot com ¶

11 年前

请注意，仅仅因为你可以<?php $dom->addChild();?>并不意味着你的 XML 在简单 XML 本身下是有效的

<?php
$dom=simplexml_load_string("<test></test>");
$dom->addChild("3D","1,2,3");
$xml=$dom->asXML();
echo $xml;
/* echos:
<?xml version="1.0"?>
<test><3D>1,2,3</3D></test>
*/

$dom=simplexml_load_string($xml);
/*
generates a whole lots of warnings,
and refuses to create an object.
*/
?>

PHP 5.3 和 5.4 中也是如此

向上

向下

felipenmoura at gmail dot com ¶

13 年前

此方法返回对特定 SimpleXMLElement 的引用。
如果你使用
<?php
 $xml= new SimpleXMLElement('<root></root>');
 $xml->father['name']= 'Fathers name'; // 自动创建一个带有 name 属性的 father 标签
 $son= $xml->father->addChild('son'); // 使用第一个 father 标签
 $son['name']= 'first son';
 $otherSon= $xml->father->addChild('son'); // 使用第一个 father 标签，但在第二个 son 标签中
 $otherSon['name']= 'second son';
 
 echo htmlentities($xml->asXML());
?>

结果将是
<root>
<father>
<son name='first son' />
<son name='second son' />
</father>
</root>

所以，一旦你改变了新添加的子元素，你实际上是访问了 SimpleXMLElement 内部作为引用的元素。

向上

向下

-3

jerikojerk ¶

13 年前

如果你正在寻找一种追加子元素的方法，你可能会对此感兴趣


<?php 
$x = new SimpleXMLElement('<root name="toplevel"></root>'); 
$f1 = new SimpleXMLElement('<child pos="1">alpha</child>'); 
$f2 = new SimpleXMLElement('<child pos="2">beta</child>'); 
$f3 = new SimpleXMLElement('<child pos="3">gamma</child>'); 
 
$x->{$f1->getName()} = $f1; 
$x->{$f2->getName()}[] = $f2; 
$x->{$f3->getName()}[] = $f3; 
 
echo 'count child=',$x->count(),"\n"; 
echo $x->asXML(); 
 
foreach ( $x->children() as $foo ) 
{ 
 var_dump($foo); 
} 
 
?>

向上

向下

-11

thallisphp at gmail dot com ¶

10年前

<?php
class MySimpleXMLElement extends SimpleXMLElement
{
 /**
 * 将 SimpleXMLElement 代码添加到 SimpleXMLElement 中
 *
 * @param SimpleXMLElement $append
 */
 public function appendXML($append)
 {
 if ($append) {
 if (strlen(trim((string)$append)) == 0) {
 $xml = $this->addChild($append->getName());
 } else {
 $xml = $this->addChild($append->getName(), (string)$append);
 }

 foreach ($append->children() as $child) {
 $xml->appendXML($child);
 }

 foreach ($append->attributes() as $n => $v) {
 $xml->addAttribute($n, $v);
 }
 }
 }
}
?>

＋添加注释