-
Notifications
You must be signed in to change notification settings - Fork 146
/
savexml.xml
175 lines (163 loc) · 4.65 KB
/
savexml.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 40476b2960f884b088d77f38b6bef2c43b662d10 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domdocument.savexml" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::saveXML</refname>
<refpurpose>
Sauvegarde l'arbre interne XML dans une chaîne de caractères
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DOMDocument">
<modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>DOMDocument::saveXML</methodname>
<methodparam choice="opt"><type class="union"><type>DOMNode</type><type>null</type></type><parameter>node</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
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.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>node</parameter></term>
<listitem>
<para>
Utilisez ce paramètre pour afficher uniquement un nœud spécifique sans déclaration XML
plutôt que la totalité du document.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
Options additionnelles.
Les options <link linkend="libxml.constants">LIBXML_NOEMPTYTAG</link>
et <link linkend="libxml.constants">LIBXML_NOXMLDECL</link> sont supportées.
Antérieur à PHP 8.3.0, uniquement l'option <link linkend="libxml.constants">LIBXML_NOEMPTYTAG</link>
est supporté.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retourne le XML ou &false; si une erreur survient.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
<variablelist>
<varlistentry>
<term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
<listitem>
<para>
Lancé si <parameter>node</parameter> est issu d'un autre document.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
<link linkend="libxml.constants">LIBXML_NOXMLDECL</link> est désormais supporté.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Sauvegarde de l'arbre DOM dans une chaîne de caractères</title>
<programlisting role="php">
<![CDATA[
<?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);
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
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>
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>DOMDocument::save</methodname></member>
<member><methodname>DOMDocument::load</methodname></member>
<member><methodname>DOMDocument::loadXML</methodname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->