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

Co-authored-by: Sergey Panteleev <sergey@php.net>
2025-07-30 12:57:40 +00:00 · 2024-02-13 11:34:58 +03:00
parent 13ad88810a
commit 001e22e001
1 changed files with 85 additions and 36 deletions
--- a/language-snippets.ent
+++ b/language-snippets.ent
@ -19,8 +19,8 @@ xmlns="http://docbook.org/ns/docbook"><simpara>С версии PHP 5.3.0 эта
 <!-- Cautions -->
 <!ENTITY caution.cryptographically-insecure '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
-  Функция не создаёт криптографически защищённые значения и <emphasis>не должна</emphasis> использоваться
-  для криптографических целей или целей, требующих, чтобы возвращаемые значения были недоступны для разгадывания.
+  Функция не создаёт криптографически безопасные значения и <emphasis>не должна</emphasis> использоваться
+  в криптографических целях или целях, которые требуют, чтобы возвращаемые значения были недоступны для разгадывания.
 </para>
 <para>
  Если нужна криптографически безопасная случайная последовательность,
@ -177,9 +177,10 @@ callback-функции при вызове функции <function>ob_start</f
 <!ENTITY note.sigchild '<note xmlns="http://docbook.org/ns/docbook"><para>Если PHP собран
 с опцией --enable-sigchild, возвращаемое значение этой функции не определено.</para></note>'>

-<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook"><para>Если оба
-сравниваемых значения эквивалентны, они сохраняют свой первоначальный порядок.
-До PHP 8.0.0 их относительный порядок в отсортированном массиве не был определён.</para></note>'>
+<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook">
+<para>Функция сохраняет первоначальный порядок элементов, если
+при сравнении значения двух элементов равны. До PHP 8.0.0 порядок элементов
+в отсортированном массиве оставался неопределённым.</para></note>'>

 <!ENTITY note.reset-index "<note xmlns='http://docbook.org/ns/docbook'>
 <para>
@ -850,10 +851,20 @@ $compareFunc = static function ($item1, $item2) {

 <!ENTITY info.method.alias 'Метод — псевдоним метода: '>

-<!ENTITY info.function.alias.deprecated '<simpara xmlns="http://docbook.org/ns/docbook">Эта функция-псевдоним устарела и существует только по причине обратной совместимости. Использование этой функции не рекомендуется, так как в будущем она может быть удалена из PHP.</simpara>'>
+<!ENTITY info.function.alias.deprecated '<simpara xmlns="http://docbook.org/ns/docbook">Эта функция-псевдоним
+устарела и сохранилась только из-за обратной совместимости.
+Функцию не рекомендуют использовать, поскольку не исключают риск удаления функции из PHP в будущем.</simpara>'>

-<!ENTITY ext.windows.path.dll 'Для работы этого модуля системной переменной Windows
-<envar xmlns="http://docbook.org/ns/docbook">PATH</envar>должны быть доступны <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>-файлы. Чтобы узнать как этого достичь, обратитесь к разделу <acronym xmlns="http://docbook.org/ns/docbook">FAQ</acronym> "<link xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.addtopath">Как добавить мою директорию с PHP в переменную Windows PATH</link>". Хотя копирование DLL-файлов из директории PHP в системную папку Windows также решает проблему (потому что системная директория по умолчанию находится в переменной <envar xmlns="http://docbook.org/ns/docbook">PATH</envar>), это не рекомендуется. <emphasis xmlns="http://docbook.org/ns/docbook">Этому модулю требуются следующие файлы в переменной <envar>PATH</envar>:</emphasis> '>
+<!ENTITY ext.windows.path.dll 'Чтобы модуль работал, системной переменной
+<envar xmlns="http://docbook.org/ns/docbook">PATH</envar>, которую содержит операционная система Windows,
+дают доступ к <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>-файлам.
+Раздел <acronym xmlns="http://docbook.org/ns/docbook">FAQ</acronym>
+«<link xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.addtopath">Как добавить директорию PHP в переменную PATH в Windows</link>»
+рассказывает, как это сделать. Не рекомендуют копировать DLL-файлы
+из директории PHP в системную папку Windows, хотя это также решает проблему (потому что системная
+директория по умолчанию записана в переменной <envar xmlns="http://docbook.org/ns/docbook">PATH</envar>).
+<emphasis xmlns="http://docbook.org/ns/docbook">Модулю нужны
+следующие файлы в переменной <envar>PATH</envar>:</emphasis> '>

 <!ENTITY manual.migration.seealso 'Смотрите также руководство по миграции для версий PHP'>

@ -942,7 +953,9 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Функция
 '>

 <!-- FileInfo -->
-<!ENTITY fileinfo.parameters.finfo '<para xmlns="http://docbook.org/ns/docbook">Экземпляр <classname>finfo</classname>, возвращаемый функцией <function>finfo_open</function>.</para>'>
+<!ENTITY fileinfo.parameters.finfo '<para xmlns="http://docbook.org/ns/docbook">Экземпляр
+<classname>finfo</classname>, который возвращает функция <function>finfo_open</function>.</para>'>
+
 <!ENTITY fileinfo.changelog.finfo-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
@ -990,13 +1003,15 @@ PHP был скомпилирован с поддержкой freetype (<option
 <!ENTITY note.gd.interpolation '<note xmlns="http://docbook.org/ns/docbook"><para>Эта функция подвержена влиянию метода интерполяции, установленным функцией <function>imagesetinterpolation</function>.</para></note>'>

 <!ENTITY gd.image.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
-<parameter>image</parameter></term><listitem><para>Объект <classname>GdImage</classname>, возвращаемый одной из функций создания изображений,
-например, такой как <function>imagecreatetruecolor</function>.</para></listitem></varlistentry>'>
+<parameter>image</parameter></term><listitem><para>Объект <classname>GdImage</classname>,
+который возвращает одна из функций, создающих изображения,
+например, <function>imagecreatetruecolor</function>.</para></listitem></varlistentry>'>

 <!ENTITY gd.font.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
-<parameter>font</parameter></term><listitem><para>Может принимать значения 1, 2, 3, 4, 5 для встроенных шрифтов в кодировке
+<parameter>font</parameter></term><listitem><para>Принимает значения
+1, 2, 3, 4, 5 для встроенных шрифтов в кодировке
 latin2 (более высокое число соответствует большему шрифту) или экземпляр <classname>GdFont</classname>,
-возвращаемый функцией <function>imageloadfont</function>..
+который возвращает функция <function>imageloadfont</function>.
 </para></listitem></varlistentry>'>

 <!ENTITY gd.changelog.gdfont-instance '<row xmlns="http://docbook.org/ns/docbook">
@ -1161,7 +1176,7 @@ $font = 'SomeFont';
 </term><listitem><para>Мультидескриптор cURL, полученный из <function>curl_multi_init</function>.</para></listitem></varlistentry>'>

 <!ENTITY curl.sh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>share_handle</parameter>
-</term><listitem><para>Разделяемый обработчик cURL, возвращаемый
+</term><listitem><para>Разделяемый обработчик cURL, который возвращает функция
 <function>curl_share_init</function>.</para></listitem></varlistentry>'>

 <!ENTITY curl.changelog.handle-param '<row xmlns="http://docbook.org/ns/docbook">
@ -1224,7 +1239,7 @@ $font = 'SomeFont';
     <term><parameter>broker</parameter></term>
     <listitem>
      <para>
-       Провайдер Enchant, возвращаемый <function>enchant_broker_init</function>.
+       Провайдер Enchant, который возвращает функция <function>enchant_broker_init</function>.
      </para>
     </listitem>
    </varlistentry>'>
@ -1233,7 +1248,7 @@ $font = 'SomeFont';
     <term><parameter>dictionary</parameter></term>
     <listitem>
      <para>
-       Словарь Enchant, возвращаемый <function>enchant_broker_request_dict</function>
+       Словарь Enchant, который возвращает функция <function>enchant_broker_request_dict</function>
       или <function>enchant_broker_request_pwl_dict</function>.
      </para>
     </listitem>
@ -1296,7 +1311,11 @@ $font = 'SomeFont';

 <!ENTITY intl.codepoint.parameter '<para xmlns="http://docbook.org/ns/docbook">Целочисленное (<type>int</type>) задание кода символа (например <literal>0x2603</literal> для <emphasis>U+2603 СНЕГОВИКА</emphasis>), или символ закодированный строку UTF-8 (например <literal>"\u{2603}"</literal>)</para>'>

-<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">Возвращаемый тип должен быть <type>int</type>, если только символ не был передан как строка UTF-8 (<type>string</type>), в этом случае вернётся строка (<type>string</type>). В случае возникновения ошибки возвращает &null;.</para>'>
+<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">Возвращаемое
+значение должно быть целым числом (<type>int</type>), если только символ
+не был передан как строка UTF-8 (<type>string</type>),
+в этом случае вернётся строка (<type>string</type>).
+В случае ошибки возвращает &null;.</para>'>

 <!ENTITY intl.codepoint.example 'Тестирование различных способов задания'>

@ -1308,9 +1327,12 @@ $font = 'SomeFont';

 <!-- LDAP notes -->

-<!ENTITY ldap.parameter.ldap 'Экземпляр <classname xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname>, возвращаемый функцией <function xmlns="http://docbook.org/ns/docbook">ldap_connect</function>.'>
+<!ENTITY ldap.parameter.ldap 'Экземпляр <classname xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname>,
+который возвращает функция <function xmlns="http://docbook.org/ns/docbook">ldap_connect</function>.'>

-<!ENTITY ldap.parameter.result 'Экземпляр <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, возвращаемый <function xmlns="http://docbook.org/ns/docbook">ldap_list</function> или <function xmlns="http://docbook.org/ns/docbook">ldap_search</function>.'>
+<!ENTITY ldap.parameter.result 'Экземпляр <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,
+который возвращает функция <function xmlns="http://docbook.org/ns/docbook">ldap_list</function>
+или <function xmlns="http://docbook.org/ns/docbook">ldap_search</function>.'>

 <!ENTITY ldap.parameter.entry 'Экземпляр <classname xmlns="http://docbook.org/ns/docbook">LDAP\ResultEntry</classname>.'>

@ -1494,7 +1516,7 @@ linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">Время

 <!-- RNP -->

-<!ENTITY rnp.parameter.ffi-description 'Объект FFI, возвращаемый функцией rnp_ffi_create.'>
+<!ENTITY rnp.parameter.ffi-description 'Объект FFI, который возвращает функция rnp_ffi_create.'>

 <!ENTITY rnp.parameter.key-format 'Формат ключа данных (GPG, KBX, G10).'>

@ -1591,16 +1613,17 @@ Etc/GMT+n и Etc/GMT-n обратные общепринятым.
 </para></listitem></varlistentry>'>

 <!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
-<listitem><para>Только для процедурного стиля: объект <classname>DateTime</classname>, возвращаемый
+<listitem><para>Только для процедурного стиля: объект <classname>DateTime</classname>, который возвращает функция
 <function>date_create</function>.</para></listitem></varlistentry>'>

 <!ENTITY date.datetime.description.modified '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
-<listitem><para>Только для процедурного стиля: объект <classname>DateTime</classname>, возвращаемый
+<listitem><para>Только для процедурного стиля: объект <classname>DateTime</classname>, который возвращает функция
 <function>date_create</function>.
 Функция изменяет этот объект.</para></listitem></varlistentry>'>

 <!ENTITY date.datetimezone.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
-<parameter>object</parameter></term><listitem><para>Только для процедурного стиля: объект <classname>DateTimeZone</classname>, возвращаемый
+<parameter>object</parameter></term><listitem><para>Только для процедурного стиля: объект <classname>DateTimeZone</classname>,
+который возвращает функция
 <function>timezone_open</function>.</para></listitem></varlistentry>'>

 <!ENTITY date.datetime.return.modifiedobjectorfalseforfailure 'Возвращает модифицированный объект <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> для применения в цепи методов&return.falseforfailure;.'>
@ -1746,8 +1769,8 @@ Etc/GMT+n и Etc/GMT-n обратные общепринятым.
 на файл, успешно открытый функциями <function>fopen</function> или
 <function>fsockopen</function> (и всё ещё не закрытый функцией <function>fclose</function>).</para>'>

-<!ENTITY fs.file.pointer '<para xmlns="http://docbook.org/ns/docbook">Указатель (<type>resource</type>)
-на файл, обычно создаваемый с помощью функции <function>fopen</function>.</para>'>
+<!ENTITY fs.file.pointer '<para xmlns="http://docbook.org/ns/docbook">Ресурс (<type>resource</type>)
+указателя файловой системы, который часто создают функцией <function>fopen</function>.</para>'>

 <!ENTITY fs.file.32bit '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Так как тип integer в PHP является целым числом со знаком, и многие платформы используют 32-х битные целые числа,
@ -1839,22 +1862,47 @@ Etc/GMT+n и Etc/GMT-n обратные общепринятым.
 <constant>OCI_CRED_EXT</constant> не поддерживается в Windows по причинам безопасности.
 </para>'>

-<!ENTITY oci.datatypes '<para xmlns="http://docbook.org/ns/docbook">За подробностями по операции отображения типов данных, осуществляемой модулем OCI8, обратитесь к <link linkend="oci8.datatypes">типам данных, поддерживаемых драйвером</link></para>'>
+<!ENTITY oci.datatypes '<para xmlns="http://docbook.org/ns/docbook">За подробностями
+по операции отображения типов данных, осуществляемой модулем OCI8,
+обратитесь к <link linkend="oci8.datatypes">типам данных, поддерживаемых драйвером</link></para>'>

-<!ENTITY oci.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Идентификатор соединения Oracle, возвращаемый <function>oci_connect</function>, <function>oci_pconnect</function>, или <function>oci_new_connect</function>.</para>'>
+<!ENTITY oci.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Идентификатор соединения Oracle,
+который возвращают функции <function>oci_connect</function>,
+<function>oci_pconnect</function>
+или <function>oci_new_connect</function>.</para>'>

-<!ENTITY oci.availability.note.10g '<note xmlns="http://docbook.org/ns/docbook"><title>Требование к версии Oracle</title><para>Эта функция доступна, если PHP слинкован с библиотеками Oracle Database начиная с версии 10<emphasis>g</emphasis> и выше.</para></note>'>
+<!ENTITY oci.availability.note.10g '<note xmlns="http://docbook.org/ns/docbook"><title>Требование
+к версии Oracle</title><para>Эта функция доступна,
+если PHP слинкован с библиотеками Oracle Database
+начиная с версии 10<emphasis>g</emphasis> и выше.</para></note>'>

-<!ENTITY oci.clientinfo.tip '<tip xmlns="http://docbook.org/ns/docbook"><title>Производительность</title><para>В старых версиях OCI8 или базы данных Oracle было возможно установить информацию о клиенте с помощью пакета <literal>DBMS_APPLICATION_INFO</literal>. Для этой цели более эффективно использование функции <function>oci_set_client_info</function>.</para></tip>'>
+<!ENTITY oci.clientinfo.tip '<tip xmlns="http://docbook.org/ns/docbook">
+<title>Производительность</title>
+<para>В старых версиях модуля OCI8 или базы
+данных Oracle была доступна установка информации о клиенте средствами
+пакета <literal>DBMS_APPLICATION_INFO</literal>. Для этого более
+эффективен вызов функции <function>oci_set_client_info</function>.</para></tip>'>

-<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook"><title>Совет по полному сканированию таблицы (roundtrip)</title><para>Некоторые, но не все OCI8-функции вызывают полное сканирование таблицы (roundtrip). Полное сканирование таблиц  не происходит для тех запросов, в которых включено кеширование результатов в базе данных.</para></caution>'>
+<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook">
+<title>Совет по полному сканированию таблицы (roundtrip)</title>
+<para>Ряд OCI8-функции вызывают полное сканирование
+таблицы (roundtrip). Функции не сканируют таблицы полностью
+для тех запросов, в которых включено кеширование результатов
+в базе данных.</para></caution>'>

-<!ENTITY oci.use.setprefetch '<para xmlns="http://docbook.org/ns/docbook">Для запросов, возвращающих большое количество рядов, производительность может быть значительно увеличена с помощью увеличения значения опции <link linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link> или использования <function>oci_set_prefetch</function>.
+<!ENTITY oci.use.setprefetch '<para xmlns="http://docbook.org/ns/docbook">Для запросов,
+которые возвращают большое количество рядов, производительность может быть
+значительно увеличена за счёт увеличения значения опции
+<link linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link>
+или вызова функции <function>oci_set_prefetch</function>.
 </para>'>


 <!ENTITY oci.arg.statement.id
-"<para xmlns='http://docbook.org/ns/docbook'>Корректный идентификатор выражения OCI8, полученный из <function>oci_parse</function> и исполненный функцией <function>oci_execute</function>, или идентификатор выражения <literal>REF CURSOR</literal>.</para>">
+"<para xmlns='http://docbook.org/ns/docbook'>Корректный идентификатор
+выражения OCI8, полученный из функции <function>oci_parse</function>
+и исполненный функцией <function>oci_execute</function>,
+или идентификатор выражения <literal>REF CURSOR</literal>.</para>">

 <!-- TODO: проверить правильность перевода -->
 <!-- PCNTL Notes -->
@ -1911,7 +1959,7 @@ Etc/GMT+n и Etc/GMT-n обратные общепринятым.
 <!ENTITY no.config '<para xmlns="http://docbook.org/ns/docbook">Данный модуль не определяет никакие директивы конфигурации в &php.ini;.</para>'>
 <!ENTITY no.resource '<para xmlns="http://docbook.org/ns/docbook">Данный модуль не определяет каких-либо типов ресурсов.</para>'>
 <!ENTITY no.constants '<para xmlns="http://docbook.org/ns/docbook">Данный модуль не определяет никакие константы.</para>'>
-<!ENTITY no.requirement '<para xmlns="http://docbook.org/ns/docbook">Для сборки этого модуля не требуются внешние библиотеки.</para>'>
+<!ENTITY no.requirement '<para xmlns="http://docbook.org/ns/docbook">Для сборки этого модуля не нужны внешние библиотеки.</para>'>
 <!ENTITY no.install '<para xmlns="http://docbook.org/ns/docbook">Для использования этих функций не требуется проведение установки,
 поскольку они являются частью ядра PHP.</para>'>

@ -2008,7 +2056,8 @@ PECL модулей</link>. Дополнительная информация,
 Если параметр <parameter>connection</parameter> указан как &null;, выбирается соединение по умолчанию. Соединение по умолчанию — это последнее соединение, которое установила функция <function>pg_connect</function> или <function>pg_pconnect</function>.
 <warning><simpara>Начиная с версии PHP 8.1.0, использование соединения по умолчанию устарело.</simpara></warning></para>'>

-<!ENTITY pgsql.parameter.result '<para xmlns="http://docbook.org/ns/docbook">Экземпляр <classname>PgSql\Result</classname>, возвращаемый функциями <function>pg_query</function>,
+<!ENTITY pgsql.parameter.result '<para xmlns="http://docbook.org/ns/docbook">Экземпляр <classname>PgSql\Result</classname>,
+который возвращают функции <function>pg_query</function>,
 <function>pg_query_params</function> или <function>pg_execute</function> (среди прочего).</para>'>

 <!ENTITY pgsql.parameter.lob '<para xmlns="http://docbook.org/ns/docbook">An <classname>PgSql\Lob</classname> instance, returned by <function>pg_lo_open</function>.</para>'>
@ -2590,8 +2639,8 @@ PHP-модуль <link linkend="book.libxml">libxml</link>. Это означа
 PHP скомпилирован с поддержкой libxml 20620 или старше.</para></caution>'>

 <!-- inotify -->
-<!ENTITY inotify.instance.description 'Ресурс, возвращаемый
-<function xmlns="http://docbook.org/ns/docbook">inotify_init</function>'>
+<!ENTITY inotify.instance.description 'Ресурс, который возвращает функция
+<function xmlns="http://docbook.org/ns/docbook">inotify_init</function>.'>

 <!-- User streams -->
 <!ENTITY userstream.not.implemented.warning '<para xmlns="http://docbook.org/ns/docbook">Вызывает ошибку уровня