From a6ff1c1cd3fbb518a449bc550e5289c8d148a81b Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Tue, 12 Nov 2024 02:36:01 +0300
Subject: [PATCH] Update libxml-disable-entity-loader.xml to en

---
 .../libxml-disable-entity-loader.xml          | 28 ++++++++++++-------
 1 file changed, 18 insertions(+), 10 deletions(-)

diff --git a/reference/libxml/functions/libxml-disable-entity-loader.xml b/reference/libxml/functions/libxml-disable-entity-loader.xml
index 98da53037..b77a6ada4 100644
--- a/reference/libxml/functions/libxml-disable-entity-loader.xml
+++ b/reference/libxml/functions/libxml-disable-entity-loader.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f3b5475eebc9a79088559e506d90cd648404bf33 Maintainer: tmn Status: ready -->
+<!-- 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>
 
@@ -20,13 +20,19 @@
    <methodparam choice="opt"><type>bool</type><parameter>disable</parameter><initializer>&true;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Отключение/включение возможности загружать внешние сущности.
-   Обратите внимание, что отключение загрузки внешних сущностей может вызвать общие проблемы
-   с загрузкой XML-документов. Однако в libxml 2.9.0 подстановка сущностей
-   отключена по умолчанию, поэтому нет необходимости отключать загрузку внешних
-   сущностей, если нет необходимости разрешать ссылки на внутренние сущности с помощью <constant>LIBXML_NOENT</constant>.
-   Как правило, лучше использовать <function>libxml_set_external_entity_loader</function>
-   для подавления загрузки внешних сущностей.
+   Функция отключает или включает возможность загрузки внешних сущностей.
+   Обратите внимание, что отключение загрузки внешних сущностей иногда вызывает общие проблемы
+   с загрузкой 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>
 
@@ -101,7 +107,9 @@
    <simplelist>
     <member><function>libxml_use_internal_errors</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>
   </para>
  </refsect1>