mirror of
https://github.com/php/doc-ru.git
synced 2025-07-21 23:23:20 +00:00
Добавление проверки EditorConfig в CI
Closes GH-10
This commit is contained in:
Alexey Pyltsyn
@ -11,5 +11,5 @@ indent_size = 2
|
||||
insert_final_newline = true
|
||||
trim_trailing_whitespace = true
|
||||
|
||||
[*.xml]
|
||||
[*.{xml,ent}]
|
||||
indent_size = 1
|
||||
|
||||
22
.github/workflows/editorconfig.yml
vendored
Normal file
22
.github/workflows/editorconfig.yml
vendored
Normal file
@ -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 }}
|
||||
2
.gitignore
vendored
2
.gitignore
vendored
@ -1 +1 @@
|
||||
.idea
|
||||
.idea
|
||||
|
||||
@ -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> или
|
||||
|
||||
Reference in New Issue
Block a user