Files
php-doc-ru/reference/libxml/functions/libxml-disable-entity-loader.xml
2024-11-12 02:36:01 +03:00

138 lines
4.5 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: eae558e584a4e5f70e5d85b5cebc59e296399924 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.libxml-disable-entity-loader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>libxml_disable_entity_loader</refname>
<refpurpose>
Отключает возможность загрузки сущностей из внешних источников
</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-8-0-0;
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>libxml_disable_entity_loader</methodname>
<methodparam choice="opt"><type>bool</type><parameter>disable</parameter><initializer>&true;</initializer></methodparam>
</methodsynopsis>
<para>
Функция отключает или включает возможность загрузки внешних сущностей.
Обратите внимание, что отключение загрузки внешних сущностей иногда вызывает общие проблемы
с загрузкой XML-документов.
</para>
<para>
С libxml 2.9.0 подстановку сущностей отключили по умолчанию,
поэтому не обязательно отключать загрузку внешних сущностей,
если не требуется разрешать ссылки на внутренние сущности через константу <constant>LIBXML_NOENT</constant>,
<constant>LIBXML_DTDVALID</constant> или <constant>LIBXML_DTDLOAD</constant>.
Для подавления загрузки внешних сущностей часто
лучше пользоваться функцией <function>libxml_set_external_entity_loader</function>.
С PHP 8.4.0 и только для Libxml &gt;= 2.13.0 доступна константа <constant>LIBXML_NO_XXE</constant>,
которая тоже подавляет загрузку из внешних источников.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>disable</parameter></term>
<listitem>
<para>
Отключение (&true;) или включение (&false;) модулей libxml
(таких как <xref linkend="book.dom" />,
<xref linkend="book.xmlwriter" /> и <xref linkend="book.xmlreader" />)
для загрузки внешних сущностей.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает предыдущее значение.
</para>
</refsect1>
<!--
<refsect1 role="errors">
&reftitle.errors;
<para>
Когда эта функция генерирует ошибки уровня E_ * и/или выбрасывает исключения.
</para>
</refsect1>
-->
<!--
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>libxml_disable_entity_loader</function> example</title>
<para>
Any text that describes the purpose of the example, or what
goes on in the example should be here.
</para>
<programlisting role="php">
<![CDATA[
<?php
/* ... */
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
...
]]>
</screen>
</example>
</para>
</refsect1>
-->
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>libxml_use_internal_errors</function></member>
<member><function>libxml_set_external_entity_loader</function></member>
<member>Константа <constant>LIBXML_NOENT</constant></member>
<member>Константа <constant>LIBXML_DTDVALID</constant></member>
<member>Константа <constant>LIBXML_NO_XXE</constant></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
-->