VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-07-21 23:23:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Mikhail Alferov
2024-11-12 02:36:01 +03:00
committed by GitHub
parent 02342ce798
commit a6ff1c1cd3
1 changed files with 18 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
reference/libxml/functions/libxml-disable-entity-loader.xml
View File

@ -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>