Обновление до английской версии

This commit is contained in:
Sergey Panteleev
2023-04-17 08:15:21 +03:00
parent 97c5f2cc32
commit 72023cd017
23 changed files with 56 additions and 148 deletions

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5581b0ca662a84f42f6aaa8dbff9acd410602278 Maintainer: shein Status: ready -->
<!-- EN-Revision: 42bd1bfed391b287e55e47fed1b8f8d22a033ee0 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.class-alias" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -45,7 +45,8 @@
<term><parameter>autoload</parameter></term>
<listitem>
<para>
Нужно ли автоматически подгружать оригинальный класс, если он не был найден.
Нужно ли <link linkend="language.oop5.autoload">автоматически подгружать</link> класс,
если он ещё не загружен.
</para>
</listitem>
</varlistentry>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9fe810352095922a68ce2807745a9bc35c0afe1f Maintainer: shein Status: ready -->
<!-- EN-Revision: 42bd1bfed391b287e55e47fed1b8f8d22a033ee0 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.class-exists" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -33,7 +33,8 @@
<term><parameter>autoload</parameter></term>
<listitem>
<para>
Вызывать ли по умолчанию &link.autoload;.
Нужно ли <link linkend="language.oop5.autoload">автоматически подгружать</link> класс,
если он ещё не загружен.
</para>
</listitem>
</varlistentry>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59d305435ca2e6e4c6cb82787c38cc97ce52ed40 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 42bd1bfed391b287e55e47fed1b8f8d22a033ee0 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.enum-exists" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -35,7 +35,8 @@
<term><parameter>autoload</parameter></term>
<listitem>
<para>
Следует ли вызывать &link.autoload; по умолчанию.
Нужно ли <link linkend="language.oop5.autoload">автоматически подгружать</link> класс,
если он ещё не загружен.
</para>
</listitem>
</varlistentry>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9fe810352095922a68ce2807745a9bc35c0afe1f Maintainer: shein Status: ready -->
<!-- EN-Revision: 42bd1bfed391b287e55e47fed1b8f8d22a033ee0 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.interface-exists" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -33,7 +33,8 @@
<term><parameter>autoload</parameter></term>
<listitem>
<para>
Определяет, использовать ли по умолчанию &link.autoload; или нет
Нужно ли <link linkend="language.oop5.autoload">автоматически подгружать</link> интерфейс,
если он ещё не загружен.
</para>
</listitem>
</varlistentry>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: de99fc78ded2299a3c59eabb26da6ae4e6a28bbd Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 42bd1bfed391b287e55e47fed1b8f8d22a033ee0 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.trait-exists" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -35,7 +35,8 @@
<term><parameter>autoload</parameter></term>
<listitem>
<para>
Пытаться ли его загрузить автоматически
Нужно ли <link linkend="language.oop5.autoload">автоматически подгружать</link> класс,
если он ещё не загружен.
</para>
</listitem>
</varlistentry>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 593ea510e853ff034e03f78a4be0daa41661c9d4 Maintainer: tmn Status: ready -->
<!-- EN-Revision: ee0403b08276f179965318623980378033d34d72 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.imagesetpixel" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -100,7 +100,7 @@ $corners[2] = array('x' => 200, 'y' => 190);
$red = imagecolorallocate($gd, 255, 0, 0);
for ($i = 0; $i < 100000; $i++) {
imagesetpixel($gd, round($x),round($y), $red);
imagesetpixel($gd, round($x), round($y), $red);
$a = rand(0, 2);
$x = ($x + $corners[$a]['x']) / 2;
$y = ($y + $corners[$a]['y']) / 2;

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9e0f03ac354d797d1d16c0fcc1663e5e170f2727 Maintainer: sergey Status: ready -->
<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="luasandbox.callfunction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -57,7 +57,7 @@
&reftitle.returnvalues;
<para>
Возвращает массив (<type>array</type>) значений, возвращаемых функцией Lua,
которые могут быть пустыми или <literal>false</literal> в случае возникновения ошибки.
которые могут быть пустыми&return.falseforfailure;.
</para>
</refsect1>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 53242ee6628dc1ae6989fe002231fddfd8f005c6 Maintainer: sergey Status: ready -->
<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="luasandbox.setcpulimit" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -43,7 +43,7 @@
<term><parameter>limit</parameter></term>
<listitem>
<para>
Ограничение как число с плавающей точкой (<type>float</type>) в секундах или <literal>false</literal>, чтобы не ограничивать.
Ограничение как число с плавающей точкой (<type>float</type>) в секундах или &false;, чтобы не ограничивать.
</para>
</listitem>
</varlistentry>

View File

@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: zors1 Status: ready -->
<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: zors1 Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="luasandboxfunction.call" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>LuaSandboxFunction::call</refname>
@ -19,7 +18,7 @@
</para>
<para>
Ошибки, вызванные PHP-кодом, приведут к тому, что функция вернёт
<literal>false</literal> и будет вызвано предупреждение
&false; и будет вызвано предупреждение
<constant>E_WARNING</constant>, например, когда тип ресурса (<type>resource</type>)
используется в качестве аргумента. При возникновении ошибок Lua будет
выброшено исключение <classname>LuaSandboxRuntimeError</classname>.
@ -148,8 +147,7 @@
&reftitle.returnvalues;
<para>
Возвращает массив значений (<type>array</type>), возвращаемых функцией,
который может быть пустым, или <literal>false</literal> в случае
возникновения ошибки.
который может быть пустым&return.falseforfailure;.
</para>
</refsect1>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c36ce0b514faa2efce1427ae87ba9ea25cc038ad Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.define" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -72,8 +72,8 @@
<simpara>
Начиная с PHP 7.3.0, определение нечувствительных к регистру констант
объявлено устаревшим.
Начиная с PHP 8.0.0, допустимым значением является только <literal>false</literal>,
передача <literal>true</literal> вызовет предупреждение.
Начиная с PHP 8.0.0, допустимым значением является только &false;,
передача &true; вызовет предупреждение.
</simpara>
</warning>
<note>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 734bafeaf071b78b15d375f9af583befddd8c2a2 Maintainer: sergey Status: ready -->
<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<book xml:id="mongodb.architecture" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<titleabbrev>Архитектура и внутреннее устройство драйвера</titleabbrev>
@ -780,7 +780,7 @@ class UpperClass implements MongoDB\BSON\Persistable {
Метод <methodname>MongoDB\BSON\Unserializable::bsonUnserialize</methodname>
класса YourClass, OurClass, OurClass выполняет итерацию по массиву и устанавливает
свойства без изменений. Он <emphasis>также</emphasis> устанавливает для свойства
<literal>$unserialized</literal> значение <literal>true</literal>:
<literal>$unserialized</literal> значение &true;:
<programlisting role="php">
<![CDATA[

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: tmn Status: ready -->
<!-- EN-Revision: d470f625f96a83d65464619297cccad7ce46e743 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.multi-query" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -25,6 +25,7 @@
Запускает на выполнение один или несколько запросов, перечисленных через
точку с запятой.
</para>
&mysqli.sqlinjection.warning;
<para>
Запросы отправляются асинхронно за один вызов базы данных, но база данных обрабатывает их последовательно.
<methodname>mysqli_multi_query</methodname> ожидает завершения первого запроса, прежде чем вернуть управление PHP.
@ -72,7 +73,6 @@
Строка, содержащая запросы, которые нужно выполнить.
Несколько запросов следует разделять точкой с запятой.
</para>
&mysqli.sqlinjection.warning;
</listitem>
</varlistentry>
</variablelist>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ec946465e5ee9dc4dc19f1a28510697066a19eac Maintainer: tmn Status: ready -->
<!-- EN-Revision: d470f625f96a83d65464619297cccad7ce46e743 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.query" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -28,6 +28,7 @@
<para>
Выполняет запрос <parameter>query</parameter> к базе данных.
</para>
&mysqli.sqlinjection.warning;
<para>
Для не DML-запросов (не INSERT, UPDATE или DELETE),
эта функция равносильна вызову
@ -79,7 +80,6 @@
<para>
Текст запроса.
</para>
&mysqli.sqlinjection.warning;
</listitem>
</varlistentry>
<varlistentry>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: tmn Status: ready -->
<!-- EN-Revision: d470f625f96a83d65464619297cccad7ce46e743 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.real-query" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -26,6 +26,7 @@
или использовать функциями <function>mysqli_store_result</function> или
<function>mysqli_use_result</function>.
</para>
&mysqli.sqlinjection.warning;
<para>
Чтобы определить, должен ли запрос возвращать результирующий набор, смотрите
<function>mysqli_field_count</function>.
@ -43,7 +44,6 @@
<para>
Текст запроса в виде строки.
</para>
&mysqli.sqlinjection.warning;
</listitem>
</varlistentry>
</variablelist>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2c672eb6214cd02024074f9028e45ae335de412e Maintainer: tmn Status: ready -->
<!-- EN-Revision: 60a292997b3c6341cf52099d901aa0b5f8673d87 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="mysqli.quickstart" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Краткое руководство</title>
@ -972,96 +972,6 @@ array(2) {
<para>
В API нет возможности эмулировать подготавливаемые запросы на клиенте.
</para>
<para>
<emphasis role="bold">Быстрое сравнение подготовленных и неподготовленных запросов</emphasis>
</para>
<para>
В таблице ниже приведено сравнение обычного и подготовленного на сервере
запросов.
</para>
<table xml:id="mysqli.quickstart.prepared.comparison">
<title>Сравнение подготовленных и неподготовленных запросов</title>
<tgroup cols="3">
<thead>
<row>
<entry></entry>
<entry>Подготовленный запрос</entry>
<entry>Обычный запрос</entry>
</row>
</thead>
<tbody>
<row>
<entry>Количество обращений к серверу, SELECT, однократное выполнение</entry>
<entry>2</entry>
<entry>1</entry>
</row>
<row>
<entry>Количество строк с текстом запроса, переданных клиентом на сервер</entry>
<entry>1</entry>
<entry>1</entry>
</row>
<row>
<entry>Количество обращений к серверу, SELECT, n-кратное выполнение</entry>
<entry>1 + n</entry>
<entry>n</entry>
</row>
<row>
<entry>Количество строк с текстом запроса, переданных клиентом на сервер</entry>
<entry>1 шаблон, n раз параметры, если есть</entry>
<entry>n раз и каждый раз разбирается</entry>
</row>
<row>
<entry>Привязка входных параметров средствами API</entry>
<entry>Есть</entry>
<entry>Нет, параметры экранируются вручную</entry>
</row>
<row>
<entry>Привязка выходных параметров средствами API</entry>
<entry>Есть</entry>
<entry>Нет</entry>
</row>
<row>
<entry>Поддерживает использование API mysqli_result</entry>
<entry>Да, используется <methodname>mysqli_stmt::get_result</methodname></entry>
<entry>Да</entry>
</row>
<row>
<entry>Буферизация результирующих наборов</entry>
<entry>
Есть, можно использовать функцию <methodname>mysqli_stmt::get_result</methodname>
или <methodname>mysqli_stmt::store_result</methodname>
</entry>
<entry>Есть, это поведение по умолчанию для <methodname>mysqli::query</methodname></entry>
</row>
<row>
<entry>Работа с небуферизованными результирующими наборами</entry>
<entry>Возможно, используется привязка выходных параметров с помощью API</entry>
<entry>
Возможно, используется функция <methodname>mysqli::real_query</methodname>
совместно с <methodname>mysqli::use_result</methodname>
</entry>
</row>
<row>
<entry>
Способ передачи данных протокола клиент-серверного взаимодействия
MySQL
</entry>
<entry>Двоичный протокол</entry>
<entry>Текстовый протокол</entry>
</row>
<row>
<entry>SQL-типы значений результирующего набора</entry>
<entry>Сохраняются при извлечении</entry>
<entry>Преобразовываются в строки или сохраняются при извлечении</entry>
</row>
<row>
<entry>Поддерживает все SQL-выражения</entry>
<entry>Последние версии MySQL поддерживают большинство, но не все</entry>
<entry>Да</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
<emphasis role="bold">Смотрите также</emphasis>
</para>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b9d8c47005f09620ee3cf5347324f7e755eb4802 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: bf345aac8b6e0c72234ca71a6f6e12d756c75371 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="oci8.dtrace" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>OCI8 и динамическая трассировка DTrace</title>
@ -374,7 +374,7 @@ php*:::oci8-execute-mode
<para>
После завершения диагностики D-скрипт можно прервать с помощью
нажатия <literal>^C</literal>.
нажатия <keycombo action='simul'><keycap>CTRL</keycap><keycap>C</keycap></keycombo>.
</para>
</section>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5b4252de4f922948110fdef85c50fd94b093bc03 Maintainer: mch Status: ready -->
<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.ob-implicit-flush" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -29,7 +29,7 @@
<term><parameter>enable</parameter></term>
<listitem>
<para>
<literal>true</literal> для включения неявного сброса, <literal>false</literal> в противном случае.
&true; для включения неявного сброса, &false; в противном случае.
</para>
</listitem>
</varlistentry>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 105769eb557af47e5f2d0bea47457827114942fa Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.sem-acquire" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -42,8 +42,8 @@
<listitem>
<para>
Указывает, должен ли процесс ждать для захвата семафора.
Если установлено в <literal>true</literal>, вызов немедленно вернёт
<literal>false</literal>, если семафор не может быть захвачен.
Если установлено в &true;, вызов немедленно вернёт
&false;, если семафор не может быть захвачен.
</para>
</listitem>
</varlistentry>

View File

@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 60809ebcf7d0c261b2f00e093e4fab70326ffc7b Maintainer: tmn Status: ready -->
<!-- EN-Revision: 42bd1bfed391b287e55e47fed1b8f8d22a033ee0 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.class-implements" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>class_implements</refname>
@ -38,7 +37,8 @@
<term><parameter>autoload</parameter></term>
<listitem>
<para>
Вызывать ли по умолчанию &link.autoload;.
Нужно ли <link linkend="language.oop5.autoload">автоматически подгружать</link> класс,
если он ещё не загружен.
</para>
</listitem>
</varlistentry>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 60809ebcf7d0c261b2f00e093e4fab70326ffc7b Maintainer: tmn Status: ready -->
<!-- EN-Revision: 42bd1bfed391b287e55e47fed1b8f8d22a033ee0 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.class-parents" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -37,7 +37,8 @@
<term><parameter>autoload</parameter></term>
<listitem>
<para>
Вызывать ли по умолчанию &link.autoload;.
Нужно ли <link linkend="language.oop5.autoload">автоматически подгружать</link> класс,
если он ещё не загружен.
</para>
</listitem>
</varlistentry>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 60809ebcf7d0c261b2f00e093e4fab70326ffc7b Maintainer: tmn Status: ready -->
<!-- EN-Revision: 42bd1bfed391b287e55e47fed1b8f8d22a033ee0 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.class-uses" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -38,7 +38,8 @@
<term><parameter>autoload</parameter></term>
<listitem>
<para>
Вызывать ли по умолчанию &link.autoload;.
Нужно ли <link linkend="language.oop5.autoload">автоматически подгружать</link> класс,
если он ещё не загружен.
</para>
</listitem>
</varlistentry>

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7f569e1f175adf1fbd0e462eba8d6bc82214c939 Maintainer: shein Status: ready -->
<!-- EN-Revision: af30c6e8acc1e90b9c4a4f44539d4215d51370ab Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strlen">
<refnamediv>
@ -37,8 +37,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Длина строки <parameter>string</parameter> в случае успешного выполнения,
и <literal>0</literal>, если <parameter>string</parameter> пуста.
Функция возвращает длину строки <parameter>string</parameter> в байтах.
</para>
</refsect1>
@ -70,12 +69,6 @@ echo strlen($str); // 7
в строке.
</para>
</note>
<note>
<para>
Функция <function>strlen</function> возвращает &null; при использовании
на массивах, а также выводит ошибку уровня <constant>E_WARNING</constant>.
</para>
</note>
</refsect1>
<refsect1 role="seealso">

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ecaa2146429a7f88de40dfce14718afc896b74c5 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 8bf3b3f0732d2b5c635f950e04e27a44b36f0cb0 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="yaf-application.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -63,7 +63,7 @@ ap.ext=php
;расширение файлов шаблонов
ap.view.ext=phtml
ap.dispatcher.defaultModuel=Index
ap.dispatcher.defaultModule=Index
ap.dispatcher.defaultController=Index
ap.dispatcher.defaultAction=index