Update libxml-disable-entity-loader.xml to en

This commit is contained in:
Mikhail Alferov
2024-11-12 02:36:01 +03:00
committed by GitHub
parent 02342ce798
commit a6ff1c1cd3

View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f3b5475eebc9a79088559e506d90cd648404bf33 Maintainer: tmn Status: ready --> <!-- EN-Revision: eae558e584a4e5f70e5d85b5cebc59e296399924 Maintainer: tmn Status: ready -->
<!-- Reviewed: no --> <!-- Reviewed: no -->
<refentry xml:id="function.libxml-disable-entity-loader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refentry xml:id="function.libxml-disable-entity-loader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv> <refnamediv>
<refname>libxml_disable_entity_loader</refname> <refname>libxml_disable_entity_loader</refname>
<refpurpose> <refpurpose>
Отключение возможности загрузки сущностей из внешних источников Отключает возможность загрузки сущностей из внешних источников
</refpurpose> </refpurpose>
</refnamediv> </refnamediv>
@ -20,13 +20,19 @@
<methodparam choice="opt"><type>bool</type><parameter>disable</parameter><initializer>&true;</initializer></methodparam> <methodparam choice="opt"><type>bool</type><parameter>disable</parameter><initializer>&true;</initializer></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
Отключение/включение возможности загружать внешние сущности. Функция отключает или включает возможность загрузки внешних сущностей.
Обратите внимание, что отключение загрузки внешних сущностей может вызвать общие проблемы Обратите внимание, что отключение загрузки внешних сущностей иногда вызывает общие проблемы
с загрузкой XML-документов. Однако в libxml 2.9.0 подстановка сущностей с загрузкой XML-документов.
отключена по умолчанию, поэтому нет необходимости отключать загрузку внешних </para>
сущностей, если нет необходимости разрешать ссылки на внутренние сущности с помощью <constant>LIBXML_NOENT</constant>. <para>
Как правило, лучше использовать <function>libxml_set_external_entity_loader</function> С 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> </para>
</refsect1> </refsect1>
@ -101,7 +107,9 @@
<simplelist> <simplelist>
<member><function>libxml_use_internal_errors</function></member> <member><function>libxml_use_internal_errors</function></member>
<member><function>libxml_set_external_entity_loader</function></member> <member><function>libxml_set_external_entity_loader</function></member>
<member><link linkend="libxml.constants">Константа <constant>LIBXML_NOENT</constant></link></member> <member>Константа <constant>LIBXML_NOENT</constant></member>
<member>Константа <constant>LIBXML_DTDVALID</constant></member>
<member>Константа <constant>LIBXML_NO_XXE</constant></member>
</simplelist> </simplelist>
</para> </para>
</refsect1> </refsect1>