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 возвращает объект SimpleXMLElement, который представляет дочерний элемент, который функция добавила к XML-узлу, если выполнилась успешно; функция возвращает значение null, если возникла ошибка.

Примеры

Замечание:

В следующем примере включается файл examples/simplexml-data.php с определением XML-строки из первого примера руководства «Основы работы с модулем SimpleXML».

Пример #1 Добавление атрибутов и потомков к SimpleXML-элементу

<?php

include 'examples/simplexml-data.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', '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: Устройство парсера</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>
   Так что же, PHP — язык программирования или всё же скриптовый язык?
   Истина откроется в этом захватывающем пародийном фильме ужасов
   в формате документальной драмы.
  </plot>
  <great-lines>
   <line>Каких только веб-задач не решает PHP!</line>
  </great-lines>
  <rating type="thumbs">7</rating>
  <rating type="stars">5</rating>
 </movie>
 <movie>
  <title>PHP2: Устройство парсера</title>
  <plot>Только люди заставляют парсер работать.</plot>
  <characters>
   <character>
    <name>Mr. Parser</name>
    <actor>John Doe</actor>
   </character>
  </characters>
  <rating type="stars">5</rating>
 </movie>
</movies>

Смотрите также