reference/libxml/functions/libxml-disable-entity-loader.xml
f3b5475eebc9a79088559e506d90cd648404bf33
...
...
@@ -7,14 +7,25 @@
7
7
<refpurpose>Disable the ability to load external entities</refpurpose>
8
8
</refnamediv>
9
9

10
+
<refsynopsisdiv>
11
+
&warn.deprecated.function-8-0-0;
12
+
</refsynopsisdiv>
13
+

10
14
<refsect1 role="description">
11
15
&reftitle.description;
12
16
<methodsynopsis>
13
17
<type>bool</type><methodname>libxml_disable_entity_loader</methodname>
14
-
<methodparam choice="opt"><type>bool</type><parameter>disable</parameter><initializer>true</initializer></methodparam>
18
+
<methodparam choice="opt"><type>bool</type><parameter>disable</parameter><initializer>&true;</initializer></methodparam>
15
19
</methodsynopsis>
16
20
<para>
17
21
Disable/enable the ability to load external entities.
22
+
Note that disabling the loading of external entities may cause general issues
23
+
with loading XML documents. However, as of libxml 2.9.0 entity substitution
24
+
is disabled by default, so there is no need to disable the loading of external
25
+
entities,
26
+
unless there is the need to resolve internal entity references with <constant>LIBXML_NOENT</constant>.
27
+
Generally, it is preferable to use <function>libxml_set_external_entity_loader</function>
28
+
to suppress loading of external entities.
18
29
</para>
19
30
</refsect1>
20
31

...
...
@@ -87,7 +98,8 @@
87
98
<para>
88
99
<simplelist>
89
100
<member><function>libxml_use_internal_errors</function></member>
90
-
<member><link linkend="libxml.constants">The <constant>LIBXML_NONET</constant> constant</link></member>
101
+
<member><function>libxml_set_external_entity_loader</function></member>
102
+
<member><link linkend="libxml.constants">The <constant>LIBXML_NOENT</constant> constant</link></member>
91
103
</simplelist>
92
104
</para>
93
105
</refsect1>
94
106