PHP 开发者大会日本 2024

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:更多解析器故事');
$movie->addChild('plot', '这都是关于让它工作的人。');

$characters = $movie->addChild('characters');
$character = $characters->addChild('character');
$character->addChild('name', '解析器先生');
$character->addChild('actor', '约翰·多伊');

$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>

参见

添加注释

用户贡献的注释 6 条注释

41
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 中处理文本值的原理)

HTH
27
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);
}
}
}
}
?>
12
johninen at gmail dot com
9 年前
在谷歌站点地图的文档中,移动站点地图需要一个如下所示的元素: <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', '你的移动网站网址');
$url_mobile->addChild('mobile:mobile', null, $mobile_schema);

为了使其正常工作,必须在根节点中设置属性 xmlns:mobile,然后在创建值为 null 的 mobile:mobile 子节点时将其用作命名空间(第三个参数)。
3
nwarap
7 年前
想继续讨论关于 & 符号的问题。

有时,你可能想对 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>
7
Volker Grabsch
13 年前
请注意,尽管 addChild() 会转义 "<" 和 ">",但它不会转义 "&" 符号。

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

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

或者,使用 htmlspecialchars(),它也会替换其他字符,但不会造成任何损害,因为 addChild() 不会再次替换它们。
1
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', '页面的标题');
$content->addAttribute('id', 1);
$content->addAttribute('enabled', 'true');

// 输出:
// <xml>
// <content id="1" enabled="true"><![CDATA[页面的标题]]></content>
// </xml>
?>
To Top