com doc/ru: Добавлен ие проверки EditorConfig в CI: .editorconfig .github/ workflows/editorconfig.yml .gitignore language-snippets .ent
[email protected] (Alexey Pyltsyn) Tue, 05 Jan 2021 18:33:14 +0000
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
Commit: 36b8f6b09b08f53e6d3dfebdcba865437d961652 Author: Alexey Pyltsyn <[email protected]> Tue, 5 Jan 2021 21:19:26 +0300 Parents: 027fe4df082e27e9ce34aab133cfd7fc3169bd58 Branches: master Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=36b8f6b09b08f53e6d3dfebdcba865437d961652 Log: Добавление проверки EditorConfig в CI Closes GH-10 Changed paths: M .editorconfig A .github/workflows/editorconfig.yml M .gitignore M language-snippets.ent
diff_36b8f6b09b08f53e6d3dfebdcba865437d961652.txt
(text/plain, 40.8 KB)
diff --git a/.editorconfig b/.editorconfig
index 9eb2dc3f1..1af1f08b2 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -11,5 +11,5 @@ indent_size = 2
insert_final_newline = true
trim_trailing_whitespace = true
-[*.xml]
+[*.{xml,ent}]
indent_size = 1
diff --git a/.github/workflows/editorconfig.yml b/.github/workflows/editorconfig.yml
new file mode 100644
index 000000000..b6a513b1e
--- /dev/null
+++ b/.github/workflows/editorconfig.yml
@@ -0,0 +1,22 @@
+name: Check EditorConfig
+
+on:
+ push:
+ branches:
+ - master
+ pull_request:
+ branches:
+ - master
+
+jobs:
+ lint:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v2
+ - name: Get changed files
+ id: get_file_changes
+ uses: trilom/[email protected]
+ with:
+ output: ' '
+ - name: Run editorconfig-checker
+ run: npx editorconfig-checker ${{ steps.get_file_changes.outputs.files }}
diff --git a/.gitignore b/.gitignore
index 723ef36f4..485dee64b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1 @@
-.idea
\ No newline at end of file
+.idea
diff --git a/language-snippets.ent b/language-snippets.ent
index 4049c6405..d09265220 100644
--- a/language-snippets.ent
+++ b/language-snippets.ent
@@ -252,7 +252,7 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была
</warning>
'>
-<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para>При использовании SSL, Microsoft IIS нарушает протокол, закрывая соединение без отправки индикатора <literal>close_notify</literal>. PHP сообщит об этом как "SSL: Fatal Protocol Error" в тот момент, когда вы достигнете конца данных. Чтобы обойти это, вы должны установить <link linkend="ini.error-reporting">error_reporting</link> на уровень, исключающий E_WARNING. PHP умеет определять, что на стороне сервера находится проблемный IIS при открытии потока с помощью обёртки <literal>https://</literal> и не выводит предупреждение. Если вы используете <function>fsockopen</function> для создания <literal>ssl://</literal> сокета, вы сами отвечаете за определение и подавление этого предупреждения.</para></warning>'>
+<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para>При использовании SSL, Microsoft IIS нарушает протокол, закрывая соединение без отправки индикатора <literal>close_notify</literal>. PHP сообщит об этом как "SSL: Fatal Protocol Error" в тот момент, когда вы достигнете конца данных. Чтобы обойти это, вы должны установить <link linkend="ini.error-reporting">error_reporting</link> на уровень, исключающий E_WARNING. PHP умеет определять, что на стороне сервера находится проблемный IIS при открытии потока с помощью обёртки <literal>https://</literal> и не выводит предупреждение. Если вы используете <function>fsockopen</function> для создания <literal>ssl://</literal> сокета, вы сами отвечаете за определение и подавление этого предупреждения.</para></warning>'>
<!ENTITY warn.undocumented.class '
<warning xmlns="http://docbook.org/ns/docbook">
@@ -306,7 +306,7 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была
<!ENTITY warn.deprecated.function.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
- Эта функция объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 7.1.0 и
+ Эта функция объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 7.1.0 и
<emphasis>УДАЛЕНА</emphasis> в PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
@@ -375,7 +375,7 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была
<term><parameter>flags</parameter></term>
<listitem>
<para>
- Необязательный второй параметр <parameter>flags</parameter>
+ Необязательный второй параметр <parameter>flags</parameter>
может использоваться для изменения поведения сортировки с использованием следующих значений:
</para>
<para>
@@ -393,20 +393,20 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была
</listitem>
<listitem>
<simpara>
- <constant>SORT_LOCALE_STRING</constant> - сравнение элементов как
- строки на основе текущего языкового стандарта. Используется языковой стандарт,
+ <constant>SORT_LOCALE_STRING</constant> - сравнение элементов как
+ строки на основе текущего языкового стандарта. Используется языковой стандарт,
который можно изменить с помощью <function>setlocale</function>
</simpara>
</listitem>
<listitem>
<simpara>
- <constant>SORT_NATURAL</constant> - сравнение элементов как строки,
+ <constant>SORT_NATURAL</constant> - сравнение элементов как строки,
используя "естественный порядок", например <function>natsort</function>
</simpara>
</listitem>
<listitem>
<simpara>
- <constant>SORT_FLAG_CASE</constant> - можно объединять
+ <constant>SORT_FLAG_CASE</constant> - можно объединять
(побитовое ИЛИ) с
<constant>SORT_STRING</constant> или
<constant>SORT_NATURAL</constant> для сортировки строк без учёта регистра
@@ -527,12 +527,12 @@ font_index</parameter></term><listitem><para>Ресурс шрифта, возв
<para>
В зависимости от того, какая библиотека GD используется в PHP, <emphasis>если
<parameter>fontfile</parameter> не начинается с символа
- <literal>/</literal>, то к имени файла будет добавлено
+ <literal>/</literal>, то к имени файла будет добавлено
<literal>.ttf</literal></emphasis> и библиотека будет пытаться искать это имя файла
по определённому библиотекой пути шрифтов.
</para>
<para>
- При использовании библиотеки GD версии ниже 2.0.18, в качестве
+ При использовании библиотеки GD версии ниже 2.0.18, в качестве
разделителя путей для разных файлов шрифтов используется
<literal>пробел</literal>, а не точка с запятой.
Непреднамеренное использование этой особенности приведёт к предупреждению:
@@ -541,7 +541,7 @@ font_index</parameter></term><listitem><para>Ресурс шрифта, возв
директорию не содержащую пробелов.
</para>
<para>
- Во многих случаях, когда шрифт находится в том же каталоге, что и
+ Во многих случаях, когда шрифт находится в том же каталоге, что и
скрипт PHP, поможет следующий трюк.
<programlisting role='php'>
<![CDATA[
@@ -557,7 +557,7 @@ $font = 'SomeFont';
</para>
<note>
<para>
- Обратите внимание, что <link linkend='ini.open-basedir'>open_basedir</link>
+ Обратите внимание, что <link linkend='ini.open-basedir'>open_basedir</link>
<emphasis>не</emphasis> применяется к <parameter>fontfile</parameter>.
</para>
</note>
@@ -669,7 +669,7 @@ dbm_identifier</parameter></term><listitem><para>Идентификатор со
<!ENTITY curl.changelog.handle-param '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
- <parameter>handle</parameter> теперь ожидает экземпляр <classname>CurlHandle</classname>;
+ <parameter>handle</parameter> теперь ожидает экземпляр <classname>CurlHandle</classname>;
раньше, ожидался ресурс (<type>resource</type>).
</entry>
</row>'>
@@ -677,7 +677,7 @@ dbm_identifier</parameter></term><listitem><para>Идентификатор со
<!ENTITY curl.changelog.multi-handle-param '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
- <parameter>multi_handle</parameter> теперь ожидает экземпляр;
+ <parameter>multi_handle</parameter> теперь ожидает экземпляр;
раньше, ожидался ресурс (<type>resource</type>).
</entry>
</row>'>
@@ -713,7 +713,7 @@ dbm_identifier</parameter></term><listitem><para>Идентификатор со
</listitem>
<listitem>
<simpara>
- До dbase 7.0.0, логические значение (<literal>L</literal>) преобразуются в
+ До dbase 7.0.0, логические значение (<literal>L</literal>) преобразуются в
<literal>1</literal> или <literal>0</literal>.
</simpara>
</listitem>
@@ -795,9 +795,9 @@ imap</parameter></term><listitem><para>Поток IMAP, полученный и
<!ENTITY ldap.warn.control-paged '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>
- Функция была объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 7.4.0
+ Функция была объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 7.4.0
и <emphasis>УДАЛЕНА</emphasis> в PHP 8.0.0.
- Вместо неё следует использовать параметр <parameter>controls</parameter> в
+ Вместо неё следует использовать параметр <parameter>controls</parameter> в
<function>ldap_search</function>.
Смотрите также <link linkend="ldap.controls">Управляющие объекты LDAP</link> для получения дополнительной информации.
</simpara>
@@ -815,7 +815,7 @@ imap</parameter></term><listitem><para>Поток IMAP, полученный и
<!ENTITY note.mbstring.encoding.internal '<note xmlns="http://docbook.org/ns/docbook"><para>Для этой функции будет
использована внутренняя кодировка или кодировка, установленная функцией <function>mb_regex_encoding</function>.</para></note>'>
-<!ENTITY note.mbstring.encoding.current '<note xmlns="http://docbook.org/ns/docbook"><para>Кодировка символов, указанная функцией <function>mb_regex_encoding</function>,
+<!ENTITY note.mbstring.encoding.current '<note xmlns="http://docbook.org/ns/docbook"><para>Кодировка символов, указанная функцией <function>mb_regex_encoding</function>,
будет по умолчанию использована для данной функции.</para></note>'>
<!ENTITY mbstring.encoding.parameter '<para xmlns="http://docbook.org/ns/docbook">Параметр <parameter>encoding</parameter>
@@ -913,7 +913,7 @@ linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">Время
Etc/GMT+n и Etc/GMT-n обратные общепринятым.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
- Например, временная зона на 8 часов вперёд от GMT, используемая в Китае,
+ Например, временная зона на 8 часов вперёд от GMT, используемая в Китае,
Западной Австралии и других местах, в действительности записана
в базе данных как <literal>Etc/GMT-8</literal>, а не как <literal>Etc/GMT+8</literal>,
который вы могли ожидать.
@@ -1058,7 +1058,7 @@ object</parameter></term><listitem><para>Только для процедурн
В этом режиме типы boolean, null и integer будут, по возможности, сохраняться.
Строковые значения <literal>"true"</literal>, <literal>"on"</literal> и <literal>"yes"</literal>
будут преобразованы в &true;. <literal>"false"</literal>, <literal>"off"</literal>, <literal>"no"</literal>
-и <literal>"none"</literal> в &false;. <literal>"null"</literal> преобразуется в &null;.
+и <literal>"none"</literal> в &false;. <literal>"null"</literal> преобразуется в &null;.
Кроме этого, все числовые строки будут, по возможности, преобразованы к целым числам.
</para>'>
@@ -1080,7 +1080,7 @@ object</parameter></term><listitem><para>Только для процедурн
<!ENTITY odbc.parameter.schema 'Схема ('owner' на языке ODBC 2).'>
<!ENTITY odbc.parameter.search 'Этот параметр принимает следующие шаблоны поиска:
-<literal xmlns="http://docbook.org/ns/docbook">%</literal> соответствующий нулю или более символам,
+<literal xmlns="http://docbook.org/ns/docbook">%</literal> соответствующий нулю или более символам,
и <literal xmlns="http://docbook.org/ns/docbook">_</literal> соответствующий ровно одному символу.'>
<!ENTITY odbc.result.driver-specific 'Драйверы могут сообщать дополнительные столбцы.'>
@@ -1109,7 +1109,7 @@ object</parameter></term><listitem><para>Только для процедурн
10<emphasis>g</emphasis> или старше. Easy Connect string для Oracle 10<emphasis>g</emphasis> принимает следующую форму:
<emphasis>[//]host_name[:port][/service_name]</emphasis>. Начиная с Oracle 11<emphasis>g</emphasis> синтаксис таков:
<emphasis>[//]host_name[:port][/service_name][:server_type][/instance_name]</emphasis>.
- В Oracle 19c были введены дополнительные параметры, включая настройки времени ожидания и проверки активности.
+ В Oracle 19c были введены дополнительные параметры, включая настройки времени ожидания и проверки активности.
Обратитесь к документации Oracle. Названия служб могут быть определены с помощью запуска Oracle утилиты <literal>lsnrctl status</literal>
на сервере базы данных.
</para>
@@ -1443,32 +1443,32 @@ field_offset</parameter></term><listitem><para>Числовое смещение
<!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">Данное расширение устарело, начиная с версии PHP 5.5.0, и удалено в PHP 7.0.0.
Используйте вместо него <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
-Смотрите также инструкцию <link linkend="mysqlinfo.api.choosing">MySQL:
-выбор API</link> и <link linkend="faq.databases.mysql.deprecated">соответствующий FAQ</link> для получения более подробной информации.
+Смотрите также инструкцию <link linkend="mysqlinfo.api.choosing">MySQL:
+выбор API</link> и <link linkend="faq.databases.mysql.deprecated">соответствующий FAQ</link> для получения более подробной информации.
Альтернативы для данной функции:</para>'>
<!ENTITY mysql.alternative.note.4-3-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 4.3.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0.
Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и
-<link linkend="faq.databases.mysql.deprecated">это FAQ</link>.
+<link linkend="faq.databases.mysql.deprecated">это FAQ</link>.
Альтернативы для этой функции:</para>'>
<!ENTITY mysql.alternative.note.5-3-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.3.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0.
Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и
-<link linkend="faq.databases.mysql.deprecated">это FAQ</link>.
+<link linkend="faq.databases.mysql.deprecated">это FAQ</link>.
Альтернативы для этой функции:</para>'>
<!ENTITY mysql.alternative.note.5-4-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.4.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0.
Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и
-<link linkend="faq.databases.mysql.deprecated">это FAQ</link>.
+<link linkend="faq.databases.mysql.deprecated">это FAQ</link>.
Альтернативы для этой функции:</para>'>
<!ENTITY mysql.alternative.note.5-5-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.5.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0.
Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и
-<link linkend="faq.databases.mysql.deprecated">это FAQ</link>.
+<link linkend="faq.databases.mysql.deprecated">это FAQ</link>.
Альтернативы для этой функции:</para>'>
<!ENTITY mysql.close.connections.result.sets '<para xmlns="http://docbook.org/ns/docbook">
@@ -1752,8 +1752,8 @@ writer</parameter></term><listitem><para>Только для процедурн
<!ENTITY phar.note.performance '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
<function>Phar::addFile</function>, <function>Phar::addFromString</function> и <function>Phar::offsetSet</function>
- сохраняет новый phar-архив каждый раз при их вызове. Если производительность вызывает беспокойство,
- вместо этого следует использовать <function>Phar::buildFromDirectory</function>
+ сохраняет новый phar-архив каждый раз при их вызове. Если производительность вызывает беспокойство,
+ вместо этого следует использовать <function>Phar::buildFromDirectory</function>
или <function>Phar::buildFromIterator</function>.
</simpara>
</note>'>
@@ -2047,7 +2047,7 @@ xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docb
<!ENTITY mongo.gridfs.store.return '<para xmlns="http://docbook.org/ns/docbook">Возвращает <literal>_id</literal> сохранённого документа. Это будет сгенерированный <classname>MongoId</classname>, за исключением случая, когда <literal>_id</literal> был явно указан в параметре <parameter>metadata</parameter>.</para>'>
<!ENTITY mongo.mongowritebatch.writeoptions.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>Массив опций записи.<informaltable><thead><row><entry>ключ</entry><entry>значение</entry></row></thead><tbody><row><entry>w (int|string)</entry><entry>Значения <link linkend="mongo.writeconcerns">контроля записи</link></entry></row><row><entry>wtimeout (int)</entry><entry><link linkend="mongo.writeconcerns">Максимальное время ожидания репликации</link></entry></row><row><entry>ordered</entry><entry>Определяет, должна ли MongoDB применять этот пакет в определённом по порядку. Упорядоченная запись запускается последовательно (по одному элементу за раз) и запись прекращается после первой же ошибки. Неупорядоченная запись может запускаться параллельно и ошибки не приводят к остановке записи. По умолчанию &true;</entry></row><row><entry>j (bool)</entry><entry>Ожидать журналирование на основном сервере (primary). Не рекомендуется, используйте вместо него опцию Контроля Записи (WriteConcern)</entry></row><row><entry>fsync (bool)</entry><entry>Ожидать fsync на основном сервере (primary). Не рекомендуется, используйте вместо него опцию Контроля Записи (WriteConcern)</entry></row></tbody></informaltable></para></listitem>'>
<!ENTITY mongo.mongowritebatch.collection.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>Объект <classname>MongoCollection</classname> для выполняемого пакета. Его опции <link linkend="mongo.writeconcerns">контроля записи</link> будут скопированы и использованы по умолчанию, если не будут переданы через <parameter>$write_options</parameter> или <methodname>MongoWriteBatch::execute</methodname>.</para></listitem>'>
-<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>server</parameter> </term> <listitem> <para> Массив, содержащий основную информацию о выбранном сервере. <informaltable> <tgroup cols="2"> <thead> <row> <entry>ключ</entry> <entry>значение</entry> </row> </thead> <tbody> <row> <entry>hash</entry> <entry>хеш сервера, например: <literal>localhost:27017;-;X;56052</literal></entry> </row> <row> <entry>type</entry> <entry>Тип узла (primary/secondary/mongos/arbiter): <literal>2</literal></entry> </row> <row> <entry>max_bson_size</entry> <entry>максимальный размер BSON, который этот узел поддерживает: <literal>16777216</literal></entry> </row> <row> <entry>max_message_size</entry> <entry>Максимальный размер сообщения, который этот узел поддерживает: <literal>48000000</literal></entry> </row> <row> <entry>request_id</entry> <entry>Идентификатор запроса для этого сообщения: <literal>42</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
+<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>server</parameter> </term> <listitem> <para> Массив, содержащий основную информацию о выбранном сервере. <informaltable> <tgroup cols="2"> <thead> <row> <entry>ключ</entry> <entry>значение</entry> </row> </thead> <tbody> <row> <entry>hash</entry> <entry>хеш сервера, например: <literal>localhost:27017;-;X;56052</literal></entry> </row> <row> <entry>type</entry> <entry>Тип узла (primary/secondary/mongos/arbiter): <literal>2</literal></entry> </row> <row> <entry>max_bson_size</entry> <entry>максимальный размер BSON, который этот узел поддерживает: <literal>16777216</literal></entry> </row> <row> <entry>max_message_size</entry> <entry>Максимальный размер сообщения, который этот узел поддерживает: <literal>48000000</literal></entry> </row> <row> <entry>request_id</entry> <entry>Идентификатор запроса для этого сообщения: <literal>42</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>булево, если операция (в случае пакетных операций) должна выполняться последовательно (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>Массив опций контроля записи (writeConcern, смотри ниже)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>значения массива writeConcern</title> <tgroup cols="2"> <thead> <row> <entry>ключ</entry> <entry>значение</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>булево, сбрасывать на диск перед запуском</entry> </row> <row> <entry>j</entry> <entry>булево, записывать в журнал перед запуском</entry> </row> <row> <entry>wtimeout</entry> <entry>целое число, миллисекунды, максимальное время, которое основной сервер (primary) ждёт подтверждение репликации</entry> </row> <row> <entry>w</entry> <entry>integer=число серверов, или string=тэг-репликации</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>Общий размер в байтах закодированного сообщения, отправляемого по сети</entry> </row> <row> <entry>request_id</entry> <entry>Идентификатор для сообщения: <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>Пространство имён MongoDB , используемого для сообщений протокола <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.alternative.class.note '<para
@@ -2058,7 +2058,7 @@ xmlns="http://docbook.org/ns/docbook">Расширение, задающее э
Никакой замены данному классу не предусмотрено.</para>'>
<!ENTITY mongo.alternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">Расширение, задающее этот метод, объявлено устаревшим. Вместо него используйте расширение <link linkend="set.mongodb">MongoDB</link>.
-Есть такие альтернативы:</para>'>
+Есть такие альтернативы:</para>'>
<!ENTITY mongo.noalternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">Расширение, задающее этот метод, объявлено устаревшим. Вместо него используйте расширение <link linkend="set.mongodb">MongoDB</link>.
Никакой замены данному методу не предусмотрено.</para>'>
@@ -2140,11 +2140,11 @@ local: {
<entry>integer</entry>
<entry>
<para>
- Максимальный период времени в миллисекундах, в течение которого может
+ Максимальный период времени в миллисекундах, в течение которого может
выполняться одна команда <literal>commitTransaction</literal>.
</para>
<para>
- Если указано, <literal>maxCommitTimeMS</literal> должно быть 32-разрядным
+ Если указано, <literal>maxCommitTimeMS</literal> должно быть 32-разрядным
целым числом со знаком, большим или равным нулю.
</para>
</entry>
@@ -2325,7 +2325,7 @@ local: {
<simpara>
На Unix, драйвер MongoDB чувствителен к сценариям, которые используют
системный вызов fork() без последующего exec(). Пользователям рекомендуется
- не переиспользовать экземпляр <classname>MongoDB\Driver\Manager</classname>
+ не переиспользовать экземпляр <classname>MongoDB\Driver\Manager</classname>
в дочернем процессе.
child process.
</simpara>
@@ -2346,8 +2346,8 @@ local: {
Опция <literal>"readPreference"</literal> не контролирует сервер, к которому
драйвер выполняет операцию; она всегда будет выполняться на этом объекте сервера.
Вместо этого, он может быть использован при выполнении операции на втором узле
- (из набора реплик, не автономный) или на узле mongos для обеспечения того, что драйвер
- устанавливает проводной протокол соответствующим образом или добавляет предпочтение чтения
+ (из набора реплик, не автономный) или на узле mongos для обеспечения того, что драйвер
+ устанавливает проводной протокол соответствующим образом или добавляет предпочтение чтения
к операции, соответственно.
</simpara>
</note>
@@ -2390,8 +2390,8 @@ local: {
<para xmlns="http://docbook.org/ns/docbook">
С каждым ресурсом ассоциированы свои мягкие и жёсткие ограничения.
Мягкие ограничения - это величина, которую ядро обещает обеспечить
- ресурсу. Жёсткие ограничения - это величина, характеризующая потолок
- мягких ресурсов. Непривилегированный процесс может управлять только своими
+ ресурсу. Жёсткие ограничения - это величина, характеризующая потолок
+ мягких ресурсов. Непривилегированный процесс может управлять только своими
мягкими ограничениями, выставляя их от 0 до величины жёсткого ограничения.
</para>
'>
@@ -2421,24 +2421,24 @@ local: {
<para>
Строка формата состоит из нуля или более директив:
обычные символы (за исключением <literal>%</literal>), которые
- просто выводятся без изменения и
+ просто выводятся без изменения и
<emphasis>спецификаторы преобразования</emphasis>, каждый из которых
требует передачи своего параметра.
</para>
-
+
<para>
Спецификаторы преобразования имеют следующий формат:
<literal>%[argnum$][flags][width][.precision]specifier</literal>.
</para>
-
+
<formalpara>
<title>Argnum</title>
<para>
- Целое число, за которым следует знак доллара <literal>$</literal>,
+ Целое число, за которым следует знак доллара <literal>$</literal>,
чтобы указать, какой числовой аргумент обрабатывать при преобразовании.
</para>
</formalpara>
-
+
<para>
<table>
<title>Флаги</title>
@@ -2460,7 +2460,7 @@ local: {
<row>
<entry><literal>+</literal></entry>
<entry>
- Печатает плюс <literal>+</literal> у не отрицательных чисел;
+ Печатает плюс <literal>+</literal> у не отрицательных чисел;
По умолчанию знак печатается только у отрицательных чисел.
</entry>
</row>
@@ -2489,7 +2489,7 @@ local: {
</tgroup>
</table>
</para>
-
+
<formalpara>
<title>Ширина</title>
<para>
@@ -2497,7 +2497,7 @@ local: {
символов, которое будет напечатано.
</para>
</formalpara>
-
+
<formalpara>
<title>Точность</title>
<para>
@@ -2508,7 +2508,7 @@ local: {
<simpara>
Для спецификаторов <literal>e</literal>, <literal>E</literal>,
<literal>f</literal> и <literal>F</literal>:
- задаёт количество цифр после десятичной запятой (по умолчанию 6).
+ задаёт количество цифр после десятичной запятой (по умолчанию 6).
</simpara>
</listitem>
<listitem>
@@ -2532,14 +2532,14 @@ local: {
</note>
</para>
</formalpara>
-
+
<note>
<simpara>
Попытка использовать спецификатор позиции со значением больше, чем
<constant>PHP_INT_MAX</constant> приведёт к выводу предупреждения.
</simpara>
</note>
-
+
<para>
<table>
<title>Спецификаторы</title>
@@ -2574,7 +2574,7 @@ local: {
<row>
<entry><literal>d</literal></entry>
<entry>
- Аргумент рассматривается как целое число и печатается
+ Аргумент рассматривается как целое число и печатается
как целое число со знаком.
</entry>
</row>
@@ -2582,7 +2582,7 @@ local: {
<entry><literal>e</literal></entry>
<entry>
Аргумент считается за число в научной нотации (т.е. 1.2e+2).
- Начиная с PHP 5.2.1, спецификатор точности задаёт количество
+ Начиная с PHP 5.2.1, спецификатор точности задаёт количество
цифр после десятичной запятой. В более ранних версиях он
задавал общее количество значащих цифр (т.е. после запятой
выводилось на 1 символ меньше).
@@ -2653,7 +2653,7 @@ local: {
<row>
<entry><literal>o</literal></entry>
<entry>
- Аргумент рассматривается как целое число и печатается
+ Аргумент рассматривается как целое число и печатается
в восьмеричном представлении.
</entry>
</row>
@@ -2666,21 +2666,21 @@ local: {
<row>
<entry><literal>u</literal></entry>
<entry>
- Аргумент рассматривается как целое число и печатается
+ Аргумент рассматривается как целое число и печатается
как беззнаковое целое число.
</entry>
</row>
<row>
<entry><literal>x</literal></entry>
<entry>
- Аргумент рассматривается как целое число и печатается в
+ Аргумент рассматривается как целое число и печатается в
шестнадцатеричном представлении (буквы будут в нижнем регистре).
</entry>
</row>
<row>
<entry><literal>X</literal></entry>
<entry>
- Аргумент рассматривается как целое число и печатается в
+ Аргумент рассматривается как целое число и печатается в
шестнадцатеричном представлении (буквы будут в верхнем регистре).
</entry>
</row>
@@ -2688,20 +2688,20 @@ local: {
</tgroup>
</table>
</para>
-
+
<warning>
<para>
Спецификатор <literal>c</literal> игнорирует значения ширины и дополнения
</para>
</warning>
-
+
<warning>
<para>
Попытка использовать спецификаторы с указанием ширины для строки в
многобайтовой кодировке может привести к неожиданным результатам.
</para>
</warning>
-
+
<para>
Переменные будут приведены к подходящему для спецификатора типу:
<table>
@@ -2864,13 +2864,13 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была
<para xmlns="http://docbook.org/ns/docbook">
Все шифруемые клиентские потоки теперь по умолчанию включают проверку пиров.
По умолчанию используется OpenSSL CA пакет для проверки сертификата
- пира. В большинстве случаев не требуется ничего делать для
+ пира. В большинстве случаев не требуется ничего делать для
соединения с серверами с правильным SSL сертификатом, так как обычно
OpenSSL уже настроен для использования хороших CA пакетов.
</para>
<para xmlns="http://docbook.org/ns/docbook">
- Стандартный CA пакет может быть переопределён глобально с помощью
+ Стандартный CA пакет может быть переопределён глобально с помощью
установки или openssl.cafile или openssl.capath строк конфигурации,
или же на уровне каждого запроса используя опции контекста
<link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> или