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

Обновление перевода (#991)

Browse Source
This commit is contained in:
Sergey Panteleev
2024-10-25 09:41:08 +03:00
committed by GitHub
parent b462b78bfc
commit 6c8516f3a1
21 changed files with 378 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
reference/dba/functions/dba-optimize.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9c4c9718261c2705fef2a490e3926751134aec32 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.dba-optimize" xmlns="http://docbook.org/ns/docbook">
<refnamediv>

2
reference/dba/functions/dba-replace.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9c4c9718261c2705fef2a490e3926751134aec32 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.dba-replace" xmlns="http://docbook.org/ns/docbook">
<refnamediv>

9
reference/dba/setup.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 8b2eba9e48eb1037f11aef36820db6b5b07fa08c Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="dba.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
@ -215,10 +215,9 @@
<section xml:id="dba.resources">
&reftitle.resources;
<para>
Функции <function>dba_open</function> и
<function>dba_popen</function> возвращают обработчик для доступа к
указанному файлу базы данных, который используется всеми остальными функциями
модуля.
До PHP 8.4.0, большинство функций DBA работало с возвращаемыми ресурсами (например,
<function>dba_open</function> возвращает положительный идентификатор ссылки DBA,
требуемый большинством функций DBA).
</para>
</section>
<!-- }}} -->

13
reference/dom/domimplementation/createdocument.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 765749a26b620538117fff4425fafb3ed5834b54 Maintainer: tmn Status: ready -->
<!-- EN-Revision: 8c38327f130598e3680c3a33b6500af641b31f15 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domimplementation.createdocument" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -11,7 +11,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DOMImplementation">
<modifier>public</modifier> <type class="union"><type>DOMDocument</type><type>false</type></type><methodname>DOMImplementation::createDocument</methodname>
<modifier>public</modifier> <type>DOMDocument</type><methodname>DOMImplementation::createDocument</methodname>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>namespace</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>qualifiedName</parameter><initializer>""</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>DOMDocumentType</type><type>null</type></type><parameter>doctype</parameter><initializer>&null;</initializer></methodparam>
@ -52,10 +52,11 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Новый объект класса <classname>DOMDocument</classname> или &false; в случае возникновения ошибки.
Новый объект класса <classname>DOMDocument</classname>.
Если аргументы <parameter>namespace</parameter>, <parameter>qualifiedName</parameter>,
и <parameter>doctype</parameter> имеют значение null, возвращаемый объект
<classname>DOMDocument</classname> будет пустым и без элемента document.
@ -101,6 +102,12 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Теперь у функции предварительный возвращаемый тип <type>DOMDocument</type>.
</entry>
</row>
<row>
<entry>8.0.3</entry>
<entry>

10
reference/dom/domxpath.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: aur Status: ready -->
<!-- EN-Revision: 0185cc34ca3528205e3bda346a4d907c28a57bc5 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.domxpath" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс DOMXPath</title>
@ -82,6 +82,14 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Теперь невозможно клонировать объект <classname>DOMXPath</classname>.
Это приведёт к выбрасыванию исключения.
До версии PHP 8.4.0 это приводило к появлению непригодного для использования объекта.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>

29
reference/filter/constants.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d83aa96e679c4e4d63390a41063469e51107c331 Maintainer: shein Status: ready -->
<!-- EN-Revision: 3a19c46045d5c8ea96754f0448a84b6db0d1e2dc Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="filter.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
@ -68,7 +68,7 @@
<listitem>
<simpara>
Переменные <link linkend="reserved.variables.session">SESSION</link>.
(ещё не реализовано)
(удалено начиная с PHP 8.0.0; ранее не было реализовано)
</simpara>
</listitem>
</varlistentry>
@ -80,7 +80,7 @@
<listitem>
<simpara>
Переменные <link linkend="reserved.variables.request">REQUEST</link>.
(ещё не реализовано)
(удалено начиная с PHP 8.0.0; ранее не было реализовано)
</simpara>
</listitem>
</varlistentry>
@ -321,6 +321,17 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.filter-sanitize-full-special-chars">
<term>
<constant>FILTER_SANITIZE_FULL_SPECIAL_CHARS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Идентификатор фильтра "full_special_chars".
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.filter-sanitize-email">
<term>
<constant>FILTER_SANITIZE_EMAIL</constant>
@ -649,6 +660,18 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.filter-flag-global-range">
<term>
<constant>FILTER_FLAG_GLOBAL_RANGE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Разрешить только глобальные адреса (согласно RFC 6890) в фильтре "validate_ip".
(Доступно начиная с PHP 8.2.0)
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.filter-flag-email-unicode">
<term>
<constant>FILTER_FLAG_EMAIL_UNICODE</constant>

24
reference/misc/functions/sapi-windows-set-ctrl-handler.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 426d9a8f156bca7be9cb5475e24ba104ee814bc1 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: eee245cdbd89dc2fd908285f588e3b9e055924e5 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.sapi-windows-set-ctrl-handler" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -33,7 +33,15 @@
<para>
Функция обратного вызова, которая будет установлена или удалена.
Эта функция будет вызываться при наступлении событий
<literal>CTRL+C</literal> и <literal>CTRL+BREAK</literal>.
<keycombo action='simul'>
<keycap>CTRL</keycap>
<keycap>C</keycap>
</keycombo>
и
<keycombo action='simul'>
<keycap>CTRL</keycap>
<keycap>BREAK</keycap>
</keycombo>.
Функция должна иметь следующую сигнатуру:
<methodsynopsis>
<type>void</type><methodname>handler</methodname>
@ -44,7 +52,7 @@
<term><parameter>event</parameter></term>
<listitem>
<simpara>
Полученное событие <literal>CTRL</literal>;
Полученное событие <keycap>CTRL</keycap>;
<constant>PHP_WINDOWS_EVENT_CTRL_C</constant>
или <constant>PHP_WINDOWS_EVENT_CTRL_BREAK</constant>.
</simpara>
@ -53,7 +61,15 @@
</variablelist>
Установка параметра <parameter>handler</parameter> в значение
&null; приведёт к игнорированию событий
<literal>CTRL+C</literal>, но не <literal>CTRL+BREAK</literal>.
<keycombo action='simul'>
<keycap>CTRL</keycap>
<keycap>C</keycap>
</keycombo>,
но не
<keycombo action='simul'>
<keycap>CTRL</keycap>
<keycap>BREAK</keycap>
</keycombo>.
</para>
</listitem>
</varlistentry>

26
reference/mysqli/mysqli/kill.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: tmn Status: ready -->
<!-- EN-Revision: 3bbf9e31d58a54743c8509cbce76567efd4de5d1 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.kill" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -56,6 +56,30 @@
&mysqli.conditionalexception;
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Оба метода <methodname>mysqli::kill</methodname> и
<function>mysqli_kill</function> устарели.
Вместо них используйте SQL-команды <literal>KILL</literal>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>

27
reference/mysqli/mysqli/ping.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: tmn Status: ready -->
<!-- EN-Revision: 1afd3581fea176162adacef6dd692dfc114410f3 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.ping" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -62,6 +62,31 @@
&mysqli.conditionalexception;
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Оба метода <methodname>mysqli::ping</methodname> и
<function>mysqli_ping</function> устарели.
Функция <literal>reconnect</literal> была недоступна,
начиная с PHP 8.2.0, что делает эту функцию устаревшей.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>

26
reference/mysqli/mysqli/refresh.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: tmn Status: ready -->
<!-- EN-Revision: 4d68e15db0907404cad6c78ac274fd8f8c31fba3 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.refresh" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -56,6 +56,30 @@
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Оба метода <methodname>mysqli::refresh</methodname> и
<function>mysqli_refresh</function> устарели.
Вместо них используйте SQL-команды <literal>FLUSH</literal>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

25
reference/mysqli/mysqli/store-result.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 90953eddaa06c6c83faf0dea76c241dfafeaa2a1 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 699e596aaba256f7c3c81be8bb309e12fbd03ef4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.store-result" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -97,6 +97,29 @@
&mysqli.conditionalexception;
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Передача параметра параметра <parameter>mode</parameter> устарела.
Начиная с PHP 8.1.0 параметр не имеет значения.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>

8
reference/reflection/reflectionproperty/isprivate.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: tmn Status: ready -->
<!-- EN-Revision: 16f66c05a4060a7d673ae1c70b656d65009407b0 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="reflectionproperty.isprivate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -30,6 +30,12 @@
<para>
&true;, если свойство закрытое, &false; в противном случае.
</para>
<note>
<simpara>
Обратите внимание, что это относится только к основной видимости,
а не к <link linkend="language.oop5.visibility-members-aviz">области видимости set</link>, если она указана.
</simpara>
</note>
</refsect1>
<refsect1 role="seealso">

8
reference/reflection/reflectionproperty/isprotected.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: tmn Status: ready -->
<!-- EN-Revision: 16f66c05a4060a7d673ae1c70b656d65009407b0 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="reflectionproperty.isprotected" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -28,6 +28,12 @@
<para>
&true;, если свойство защищённое, &false; в противном случае.
</para>
<note>
<simpara>
Обратите внимание, что это относится только к основной видимости,
а не к <link linkend="language.oop5.visibility-members-aviz">области видимости set</link>, если она указана.
</simpara>
</note>
</refsect1>
<refsect1 role="seealso">

10
reference/reflection/reflectionproperty/ispublic.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: tmn Status: ready -->
<!-- EN-Revision: 16f66c05a4060a7d673ae1c70b656d65009407b0 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="reflectionproperty.ispublic" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -26,8 +26,14 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&true;, если свойство общедоступное, &false; в противном случае.
&true;, если свойство отмечено как общедоступное, &false; в противном случае.
</para>
<note>
<simpara>
Обратите внимание, что это относится только к основной видимости,
а не к <link linkend="language.oop5.visibility-members-aviz">области видимости set</link>, если она указана.
</simpara>
</note>
</refsect1>
<refsect1 role="seealso">

36
reference/simplexml/functions/simplexml-import-dom.xml
View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d715365c098db000eaf7dcd987ee6093f6e83091 Maintainer: aur Status: ready -->
<!-- EN-Revision: 62514381ff35348ffc4061b691132e36adf96210 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.simplexml-import-dom" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>simplexml_import_dom</refname>
<refpurpose>
Получает объект класса <literal>SimpleXMLElement</literal> из узла DOM
Получает объект класса <literal>SimpleXMLElement</literal> из узла XML или HTML
</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -55,6 +55,38 @@
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<simpara>
Выбрасывает ошибку <classname>TypeError</classname>, если переданный
узел <parameter>node</parameter> не XML и не HTML.
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Функция теперь выбрасывает ошибку <classname>TypeError</classname>
вместо <classname>ValueError</classname>,
если переданный узел <parameter>node</parameter> не XML и не HTML.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>

90
reference/sodium/constants.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5671f3fe71c2b96d129896e1f6ed73cf081e5246 Maintainer: lex Status: ready -->
<!-- EN-Revision: 01cb7d495c454cea3828d75e181241b6ac3f15ae Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="sodium.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
@ -76,6 +76,94 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sodium-crypto-aead-aegis128l-keybytes">
<term>
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_KEYBYTES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Доступно, начиная с PHP 8.4.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sodium-crypto-aead-aegis128l-nsecbytes">
<term>
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_NSECBYTES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Доступно, начиная с PHP 8.4.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sodium-crypto-aead-aegis128l-npubbytes">
<term>
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_NPUBBYTES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Доступно, начиная с PHP 8.4.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sodium-crypto-aead-aegis128l-abytes">
<term>
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_ABYTES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Доступно, начиная с PHP 8.4.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sodium-crypto-aead-aegis256-keybytes">
<term>
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_KEYBYTES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Доступно, начиная с PHP 8.4.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sodium-crypto-aead-aegis256-nsecbytes">
<term>
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_NSECBYTES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Доступно, начиная с PHP 8.4.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sodium-crypto-aead-aegis256-npubbytes">
<term>
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_NPUBBYTES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Доступно, начиная с PHP 8.4.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sodium-crypto-aead-aegis256-abytes">
<term>
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_ABYTES</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Доступно, начиная с PHP 8.4.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sodium-crypto-aead-aes256gcm-keybytes">
<term>
<constant>SODIUM_CRYPTO_AEAD_AES256GCM_KEYBYTES</constant>

17
reference/tidy/tidy/construct.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2b84fa46e30d9611e9b5d3af877a7e9ab5c7411a Maintainer: mch Status: ready -->
<!-- EN-Revision: f02317164cb39512509817e78ef121e3304f6810 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="tidy.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -75,6 +75,14 @@
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<simpara>
Выбрасывает исключение, в случае возникновения ошибки конструктора
(например, не удаётся открыть файл).
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
@ -86,6 +94,13 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Теперь выбрасывается исключение в случае возникновения ошибки конструктора
вместо того, чтобы молча создавать непригодный объект.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>

18
reference/ui/ui.area.xml
View File

@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: lex Status: ready -->
<!-- EN-Revision: eee245cdbd89dc2fd908285f588e3b9e055924e5 Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.ui-area" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Area</title>
@ -88,21 +87,30 @@
<varlistentry xml:id="ui-area.constants.ctrl">
<term><constant>UI\Area::Ctrl</constant></term>
<listitem>
<para>Должен быть установлен в модификаторах, которые передали событиям клавиш и мыши, когда активна клавиша CTRL</para>
<simpara>
Должен быть установлен в модификаторах, которые передали событиям клавиш и мыши,
когда активна клавиша <keycap>CTRL</keycap>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ui-area.constants.alt">
<term><constant>UI\Area::Alt</constant></term>
<listitem>
<para>Должен быть установлен в модификаторах, которые передали событиям клавиш и мыши, когда активна клавиша ALT</para>
<simpara>
Должен быть установлен в модификаторах, которые передали событиям клавиш и мыши,
когда активна клавиша <keycap>ALT</keycap>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ui-area.constants.shift">
<term><constant>UI\Area::Shift</constant></term>
<listitem>
<para>Должен быть установлен в модификаторах, которые передали событиям клавиш и мыши, когда активна клавиша SHIFT</para>
<simpara>
Должен быть установлен в модификаторах, которые передали событиям клавиш и мыши,
когда активна клавиша <keycap>SHIFT</keycap>.
</simpara>
</listitem>
</varlistentry>

15
reference/xml/constants.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: mch Status: ready -->
<!-- EN-Revision: 9acfa18973f304f8f2d531f28dd12b12c2b84f8b Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="xml.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
@ -258,6 +258,19 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.xml-option-parse-huge">
<term>
<constant>XML_OPTION_PARSE_HUGE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Доступно, начиная с PHP 8.4.0.
При использовании libxml2 &lt; 2.7.0 (например, на PHP 7.x),
эта опция включена по умолчанию и не может быть отключена.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.xml-option-target-encoding">
<term>
<constant>XML_OPTION_TARGET_ENCODING</constant>

3
reference/xml/functions/xml-parser-get-option.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9fb00a4cf8563ea56d53cb1f72e2856b68899646 Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9acfa18973f304f8f2d531f28dd12b12c2b84f8b Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.xml-parser-get-option" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -37,6 +37,7 @@
<simpara>
Какую настройку получить. Доступные настройки:
<constant>XML_OPTION_CASE_FOLDING</constant>,
<constant>XML_OPTION_PARSE_HUGE</constant>,
<constant>XML_OPTION_SKIP_TAGSTART</constant>, <constant>XML_OPTION_SKIP_WHITE</constant>
и <constant>XML_OPTION_TARGET_ENCODING</constant>. Они описаны
в документации к функции <function>xml_parser_set_option</function>.

18
reference/xml/functions/xml-parser-set-option.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9fb00a4cf8563ea56d53cb1f72e2856b68899646 Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9acfa18973f304f8f2d531f28dd12b12c2b84f8b Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.xml-parser-set-option" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -60,6 +60,16 @@
анализатора. Включено по умолчанию.
</entry>
</row>
<row>
<entry><constant>XML_OPTION_PARSE_HUGE</constant></entry>
<entry>bool</entry>
<entry>
Позволяет разбирать документы размером более 10 МБ.
Настройка должна быть включена только в том случае, если размер документа ограничен,
поскольку в противном случае это может привести к DoS.
Настройка доступна только при использовании libxml2.
</entry>
</row>
<row>
<entry><constant>XML_OPTION_SKIP_TAGSTART</constant></entry>
<entry>integer</entry>
@ -137,6 +147,12 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Добавлена настройка <constant>XML_OPTION_PARSE_HUGE</constant>.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>