Ajoute un nouveau fils à la fin des fils

# DOMNode::appendChild

(PHP 5, PHP 7, PHP 8)

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

### Description

public function 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, p. ex. DOMDocument::createElement(), DOMDocument::createTextNode(), etc. ou simplement en utilisant tout autre nœud.

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

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

Peut lancer une DOMException avec les codes d'erreur suivants :

`DOM_NO_MODIFICATION_ALLOWED_ERR`

  Levé 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`

  Levé 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`

  Levé si `node` a été créé à partir d'un document différent de celui qui a créé ce nœud.

### Exemples

L'exemple suivant ajoutera un nouveau nœud élément à 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open