Update constants.xml to en

2025-07-21 23:23:20 +00:00 · 2024-11-12 02:55:00 +03:00
parent 8f8500e026
commit 232045e77c
1 changed files with 48 additions and 32 deletions
--- a/reference/libxml/constants.xml
+++ b/reference/libxml/constants.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f7745f9df0aae7fda0b72b67ab13b19be4abf3a1 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: eae558e584a4e5f70e5d85b5cebc59e296399924 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <appendix xml:id="libxml.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
@ -12,11 +12,11 @@
   </term>
   <listitem>
    <simpara>
-     Позволяет корректно сообщать о номерах строк больше 65535.
+     Разрешает корректно сообщать о номерах строк больше 65535.
    </simpara>
    <note>
     <para>
-      Доступно начиная с PHP 7.0.0 с Libxml &gt;= 2.9.0
+      Константа доступна с PHP 7.0.0 с библиотекой Libxml &gt;= 2.9.0
     </para>
    </note>
   </listitem>
@ -28,8 +28,8 @@
   </term>
   <listitem>
    <simpara>
-     Активирует оптимизацию выделения памяти для небольших узлов. Это может
-     повысить быстродействие приложения без внесения изменений в коде.
+     Активирует оптимизацию выделения памяти для небольших узлов.
+     Иногда это повышает быстродействие приложения без внесения изменений в коде.
    </simpara>
    <note>
     <para>
@ -45,8 +45,15 @@
   </term>
   <listitem>
    <simpara>
-     DTD-атрибуты по умолчанию
+     DTD-атрибуты по умолчанию.
    </simpara>
+    <caution>
+     <simpara>
+      Включение загрузки DTD-атрибутов включит получение внешних сущностей.
+      С PHP 8.4.0 и библиотеки Libxml &gt;= 2.13.0 доступна константа <constant>LIBXML_NO_XXE</constant>,
+      которая подавляет загрузку из внешних источников.
+     </simpara>
+    </caution>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.libxml-dtdload">
@ -56,8 +63,15 @@
   </term>
   <listitem>
    <simpara>
-     Загрузка внешнего подмножества
+     Загрузка внешнего подмножества.
    </simpara>
+    <caution>
+     <simpara>
+      Включение загрузки внешних подмножеств включит получение внешних сущностей.
+      С PHP 8.4.0 и библиотеки Libxml &gt;= 2.13.0 доступна константа <constant>LIBXML_NO_XXE</constant>,
+      которая подавляет загрузку из внешних источников.
+     </simpara>
+    </caution>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.libxml-dtdvalid">
@ -67,11 +81,13 @@
   </term>
   <listitem>
    <simpara>
-     Проверка корректности документа с помощью DTD
+     Проверка корректности документа через DTD.
    </simpara>
    <caution>
     <simpara>
-      Включение проверки DTD может способствовать атакам XML External Entity (XXE).
+      Включение проверки DTD способствует XXE-атакам (англ. сокр.: XML External Entity).
+      С PHP 8.4.0 и библиотеки Libxml &gt;= 2.13.0 доступна константа <constant>LIBXML_NO_XXE</constant>,
+      которая подавляет загрузку из внешних источников.
     </simpara>
    </caution>
   </listitem>
@ -88,7 +104,7 @@
    </simpara>
    <note>
     <para>
-      Доступно только в Libxml &gt;= 2.7.7 (начиная с PHP &gt;= 5.4.0)
+      Константа доступна только в библиотеке Libxml &gt;= 2.7.7 с PHP &gt;= 5.4.0
     </para>
    </note>
   </listitem>
@ -105,7 +121,7 @@
    </simpara>
    <note>
     <para>
-      Доступно только в Libxml &gt;= 2.7.8 (начиная с &gt;= 5.4.0)
+      Константа доступна только в библиотеке Libxml &gt;= 2.7.8 с PHP &gt;= 5.4.0
     </para>
    </note>
   </listitem>
@ -128,7 +144,7 @@
   </term>
   <listitem>
    <simpara>
-     Удаление пустых узлов
+     Удаление пустых узлов.
    </simpara>
   </listitem>
  </varlistentry>
@ -139,7 +155,7 @@
   </term>
   <listitem>
    <simpara>
-     Объединить CDATA как текстовые узлы
+     Объединить CDATA как текстовые узлы.
    </simpara>
   </listitem>
  </varlistentry>
@ -150,8 +166,8 @@
   </term>
   <listitem>
    <simpara>
-     Разворачивать пустые теги (например, <literal>&lt;br/&gt;</literal> в
-     <literal>&lt;br&gt;&lt;/br&gt;</literal>)
+     Разворачивать пустые теги, например <literal>&lt;br/&gt;</literal>
+     в <literal>&lt;br&gt;&lt;/br&gt;</literal>.
    </simpara>
    <note>
     <para>
@ -169,11 +185,11 @@
   </term>
   <listitem>
    <simpara>
-     Замещение сущностей
+     Замещение сущностей.
    </simpara>
    <caution>
     <simpara>
-      Включение замещения объекта может облегчить атаки на внешний объект XML (XXE).
+      Включение замещения объекта способствует XXE-атакам (англ. сокр.: XML External Entity).
     </simpara>
    </caution>
   </listitem>
@ -185,7 +201,7 @@
   </term>
   <listitem>
    <simpara>
-     Запретить отчёты об ошибках
+     Запретить отчёты об ошибках.
    </simpara>
   </listitem>
  </varlistentry>
@ -196,7 +212,7 @@
   </term>
   <listitem>
    <simpara>
-     Отключить доступ к сети во время загрузки документов
+     Отключить доступ к сети во время загрузки документов.
    </simpara>
   </listitem>
  </varlistentry>
@ -207,7 +223,7 @@
   </term>
   <listitem>
    <simpara>
-     Запретить предупреждения
+     Запретить предупреждения.
    </simpara>
   </listitem>
  </varlistentry>
@ -218,7 +234,7 @@
   </term>
   <listitem>
    <simpara>
-     Убрать объявление XML при сохранении документа
+     Убрать объявление XML при сохранении документа.
    </simpara>
    <note>
     <para>
@ -238,7 +254,7 @@
    </simpara>
    <note>
     <para>
-      Константа доступна только в Libxml &gt;= 2.13.0, начиная с PHP 8.4.0.
+      Константа доступна только в библиотеке Libxml &gt;= 2.13.0 с PHP 8.4.0.
     </para>
    </note>
   </listitem>
@ -250,7 +266,7 @@
   </term>
   <listitem>
    <simpara>
-     Удалить лишние объявления пространств имён
+     Удалить лишние объявления пространств имён.
    </simpara>
   </listitem>
  </varlistentry>
@ -311,7 +327,7 @@
   </term>
   <listitem>
    <simpara>
-     Реализовать замещение XInclude
+     Реализовать замещение XInclude.
    </simpara>
   </listitem>
  </varlistentry>
@ -322,7 +338,7 @@
   </term>
   <listitem>
    <simpara>
-     Устранимая ошибка
+     Устранимая ошибка.
    </simpara>
   </listitem>
  </varlistentry>
@ -333,7 +349,7 @@
   </term>
   <listitem>
    <simpara>
-     Фатальная ошибка
+     Фатальная ошибка.
    </simpara>
   </listitem>
  </varlistentry>
@ -344,7 +360,7 @@
   </term>
   <listitem>
    <simpara>
-     Нет ошибок
+     Нет ошибок.
    </simpara>
   </listitem>
  </varlistentry>
@ -355,7 +371,7 @@
   </term>
   <listitem>
    <simpara>
-     Простое предупреждение
+     Простое предупреждение.
    </simpara>
   </listitem>
  </varlistentry>
@ -366,7 +382,7 @@
   </term>
   <listitem>
    <simpara>
-     Версия libxml в виде 20605 или 20617
+     Версия библиотеки libxml в виде 20605 или 20617.
    </simpara>
   </listitem>
  </varlistentry>
@ -377,7 +393,7 @@
   </term>
   <listitem>
    <simpara>
-     Версия libxml в виде 2.6.5 или 2.6.17
+     Версия библиотеки libxml в виде 2.6.5 или 2.6.17.
    </simpara>
   </listitem>
  </varlistentry>
@ -388,11 +404,11 @@
   </term>
   <listitem>
    <simpara>
-     Создаёт со значением по умолчанию или фиксированные узлы при проверке схемы XSD
+     Создаёт со значением по умолчанию или фиксированные узлы при проверке схемы XSD.
    </simpara>
    <note>
     <para>
-      Доступно только в Libxml &gt;= 2.6.14 (в PHP &gt;= 5.5.2)
+      Константа доступна только в библиотеке Libxml &gt;= 2.6.14 с PHP &gt;= 5.5.2
     </para>
    </note>
   </listitem>