DOMDocument::saveXML

(PHP 5, PHP 7, PHP 8)

DOMDocument::saveXML — Sauvegarde l'arbre interne XML dans une chaîne de caractères

Description

public DOMDocument::saveXML(?DOMNode $node = null, int $options = 0): string|false

Crée un document XML depuis la représentation DOM. Cette fonction est habituellement appelée après la création d'un tout nouveau document DOM, comme dans l'exemple ci-dessous.

Liste de paramètres

node: Utiliser ce paramètre pour afficher uniquement un nœud spécifique sans déclaration XML plutôt que la totalité du document.
options: Options supplémentaires. Les options LIBXML_NOEMPTYTAG et LIBXML_NOXMLDECL sont prises en charge. Avant PHP 8.3.0, seule l'option LIBXML_NOEMPTYTAG est prise en charge.

Valeurs de retour

Retourne le XML ou false si une erreur survient.

Erreurs / Exceptions

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

DOM_WRONG_DOCUMENT_ERR: Levé si node est issu d'un autre document.

Historique

Version	Description
8.3.0	LIBXML_NOXMLDECL est désormais supporté.

Exemples

Exemple #1 Sauvegarde de l'arbre DOM dans une chaîne de caractères

<?php

$doc = new DOMDocument('1.0');
// nous voulons un joli affichage
$doc->formatOutput = true;

$root = $doc->createElement('book');
$root = $doc->appendChild($root);

$title = $doc->createElement('title');
$title = $root->appendChild($title);

$text = $doc->createTextNode('Ceci est le titre');
$text = $title->appendChild($text);

echo "Récupération de tout le document :\n";
echo $doc->saveXML() . "\n";

echo "Récupération du titre, uniquement :\n";
echo $doc->saveXML($title);

?>

L'exemple ci-dessus va afficher :

Récupération de tout le document :
<?xml version="1.0"?>
<book>
  <title>Ceci est le titre</title>
</book>

Récupération du titre, uniquement :
<title>Ceci est le titre</title>

Voir aussi

DOMDocument::save() - Sauvegarde l'arbre interne XML dans un fichier
DOMDocument::load() - Charge du XML depuis un fichier
DOMDocument::loadXML() - Charge du XML depuis une chaîne de caractères