com doc/ru: Добавлен ие проверки EditorConfig в CI: .editorconfig .github/ workflows/editorconfig.yml .gitignore language-snippets
.ent
| From: | Alexey Pyltsyn | Date: | Tue, 05 Jan 2021 18:33:14 +0000 |
| Subject: | com doc/ru: Добавлен ие проверки EditorConfig в CI: .editorconfig .github/ workflows/editorconfig.yml .gitignore language-snippets .ent |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-8721@lists.php.net to get a copy of this message | ||
Commit: 36b8f6b09b08f53e6d3dfebdcba865437d961652
Author: Alexey Pyltsyn <lex61rus@gmail.com> 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 --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/file-changes-action@v1.2.3 + 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> или
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/file-changes-action@v1.2.3 + 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> или