# DOMNode::appendChild

(PHP 5, PHP 7, PHP 8)

DOMNode::appendChild — Ajoute un nouveau fils à la fin des fils

### Description

public DOMNode::appendChild(DOMNode `$node`): DOMNode|false

Cette fonction ajoute un fils à une liste de fils existante ou crée une nouvelle liste de fils. Le fils peut être créé avec, e.g. DOMDocument::createElement(), DOMDocument::createTextNode(), etc. ou simplement en utilisant tout autre nœud.

Lors de l'utilisation d'un nœud existant, il sera supprimé.

### Liste de paramètres

`node`

  Le nœud fils à ajouter.

### Valeurs de retour

Le nœud fils ajouté ou `false` en cas d'erreur.

### Erreurs / Exceptions

`DOM_NO_MODIFICATION_ALLOWED_ERR`

  Lancé si le nœud est en lecture seule ou si le parent précédent le nœud à insérer est en lecture seule.

`DOM_HIERARCHY_REQUEST_ERR`

  Lancé si le nœud est d'un type qui n'autorise pas d'enfant du type du nœud `node`, ou si le nœud à ajouter est un des nœuds ancêtres ou ce nœud lui-même.

`DOM_WRONG_DOCUMENT_ERR`

  Lancé si `node` a été créé depuis un document différent que celui qui a créé ce nœud.

### Exemples

L'exemple suivant ajoutera un nouveau nœud à un document nouveau.

Exemple #1 Ajout d'un fils

`<?php
$doc = new DOMDocument;
$node = $doc->createElement("para");
$newnode = $doc->appendChild($node);
echo $doc->saveXML();
?>`

Exemple #2 Enfant imbriqué

`<?php
$doc = new DOMDocument;
$headNode = $doc->createElement("head");
$doc->appendChild($headNode);
$titleNode = $doc->createElement("title");
$headNode->appendChild($titleNode);
echo $doc->saveXML();
?>`

### Voir aussi

- DOMChildNode::after() - Ajoute des nœuds après le nœud
- DOMNode::insertBefore() - Ajoute un nouveau fils avant un nœud de référence.
- DOMNode::removeChild() - Supprime un fils de la liste des enfants
- DOMNode::replaceChild() - Remplace un fils