VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-08-20 23:31:15 +00:00
Code Issues Packages Projects Releases Wiki Activity

upd: actual en-revision

Browse Source 
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@347966 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
sergey
2019-09-10 07:14:14 +00:00
parent b57514770c
commit 57881e4aca
1 changed files with 241 additions and 69 deletions
Download Patch File Download Diff File Expand all files Collapse all files

310
reference/mongodb/mongodb/driver/manager/construct.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f38246fb1fb476014b49130d2903f3f7ac6ae0f5 Maintainer: lex Status: ready -->
<!-- EN-Revision: d5a7d85201bb61b91355b7368d55c99f54b9f781 Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mongodb-driver-manager.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -325,18 +325,36 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
</para>
</entry>
</row>
<row>
<entry>retryReads</entry>
<entry><type>boolean</type></entry>
<entry>
<para>
Указывает, должен ли драйвер автоматически повторять
определенные операции чтения, которые не выполняются из-за временных сетевых ошибок
или выборов набора реплик. Требуется MongoDB 3.6+.
По умолчанию &true;.
</para>
<para>
Смотрите
<link xlink:href="&url.mongodb.specs;/blob/master/source/retryable-reads/retryable-reads.rst">Спецификацию по Retryable Reads</link>
для получения дополнительной информации.
</para>
</entry>
</row>
<row>
<entry>retryWrites</entry>
<entry><type>boolean</type></entry>
<entry>
<para>
Если &true; драйвер автоматически повторить определенные операции записи,
которые не выполнились из-за временных ошибок сети или выбора реплик.
По умолчанию &false;.
Указывает, должен ли драйвер автоматически повторять
определенные операции записи, которые не выполняются из-за временных сетевых ошибок
или выборов набора реплик. Требуется MongoDB 3.6+.
По умолчанию &true;.
</para>
<para>
См.
<link xlink:href="&url.mongodb.docs;core/distributed-queries/#retryable-writes">Retryable Writes</link>
Смотрите
<link xlink:href="&url.mongodb.docs;core/retryable-writes/">Retryable Writes</link>
в руководстве MongoDB для получения дополнительной информации.
</para>
</entry>
@ -424,6 +442,106 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
Создает соединение с TLS/SSL, если &true;. По умолчанию -
&false;.
</para>
<para>
Параметр является устаревшим псевдонимом для параметра
URI <literal>"tls"</literal>.
</para>
</entry>
</row>
<row>
<entry>tls</entry>
<entry><type>boolean</type></entry>
<entry>
<para>
Инициирует соединение с TLS/SSL, если &true;.
По умолчанию &false;.
</para>
</entry>
</row>
<row>
<entry>tlsAllowInvalidCertificates</entry>
<entry><type>boolean</type></entry>
<entry>
<para>
Указывает, должен ли драйвер выдавать ошибку, если
сертификат TLS сервера недействителен. По умолчанию
&false;.
</para>
<warning>
<simpara>
Отключение проверки сертификата создает уязвимость.
</simpara>
</warning>
</entry>
</row>
<row>
<entry>tlsAllowInvalidHostnames</entry>
<entry><type>boolean</type></entry>
<entry>
<para>
Указывает, должен ли драйвер выдавать ошибку
при несоответствии имени хоста сервера и имени хоста, указанного
в сертификате TLS. По умолчанию &false;.
</para>
<warning>
<simpara>
Отключение проверки сертификата создает уязвимость.
Разрешение недопустимых имен хоста может привести к атаке типа
<link xlink:href="&url.mongodb.wiki.mitm;">"человек посередине" (man-in-the-middle)</link>.
</simpara>
</warning>
</entry>
</row>
<row>
<entry>tlsCAFile</entry>
<entry><type>string</type></entry>
<entry>
<para>
Путь к файлу с одним или несколькими центрами сертификации,
которые следует считать доверенными при установлении соединения TLS.
По умолчанию будет использоваться хранилище системных сертификатов.
</para>
</entry>
</row>
<row>
<entry>tlsCertificateKeyFile</entry>
<entry><type>string</type></entry>
<entry>
<para>
Путь к файлу сертификата клиента или файлу закрытого ключа клиента;
в случае, если они оба необходимы, файлы должны быть объединены.
</para>
</entry>
</row>
<row>
<entry>tlsCertificateKeyFilePassword</entry>
<entry><type>string</type></entry>
<entry>
<para>
Пароль для расшифровки закрытого ключа клиента (т.е.
параметра URI <literal>"tlsCertificateKeyFile"</literal>), который будет использоваться для соединений TLS.
</para>
</entry>
</row>
<row>
<entry>tlsInsecure</entry>
<entry><type>boolean</type></entry>
<entry>
<para>
Ослабьте ограничения TLS в максимально возможной степени.
При значении &true; этот параметр имеет тот же эффект, что и указание значения &true; для обоих параметров URI
<literal>tlsAllowInvalidCertificates</literal>
и
<literal>"tlsAllowInvalidHostnames"</literal>.
По умолчанию &false;.
</para>
<warning>
<simpara>
Отключение проверки сертификата создает уязвимость.
Разрешение недопустимых имен хоста может привести к атаке типа
<link xlink:href="&url.mongodb.wiki.mitm;">"человек посередине" (man-in-the-middle)</link>.
</simpara>
</warning>
</entry>
</row>
<row>
@ -506,6 +624,11 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
Разрешение недопустимых имен хоста может привести к атаке типа
<link xlink:href="&url.mongodb.wiki.mitm;">"человек посередине" (man-in-the-middle)</link>.
</para>
<para>
Этот параметр является устаревшим псевдонимом
для параметра URI
<literal>"tlsAllowInvalidHostnames"</literal>
</para>
</entry>
</row>
<row>
@ -516,10 +639,6 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
Путь к корректно захешированному каталогу сертификатов. По умолчанию будет
использоваться хранилище системных сертификатов.
</para>
<para>
Если не указан, то используется устаревший параметр
SSL-контекста <literal>"capath"</literal>.
</para>
</entry>
</row>
<row>
@ -527,12 +646,64 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
<entry><type>string</type></entry>
<entry>
<para>
Путь к файлу центра сертификации. По умолчанию будет
Путь к файлу с одним или несколькими центрами сертификации,
которые следует считать доверенными при установлении соединения TLS.
По умолчанию будет
использоваться хранилище системных сертификатов.
</para>
<para>
Если не указан, то используется устаревший параметр
SSL-контекста <literal>"cafile"</literal>
Параметр является устаревшим псевдонимом
для параметра URI <literal>"tlsCAFile"</literal>.
</para>
</entry>
</row>
<row>
<entry>context</entry>
<entry><type>resource</type></entry>
<entry>
<para>
<link linkend="context.ssl">Параметры контекста SSL</link> для использования
в качестве запасного варианта, если не указана опция драйвера или эквивалентная ей опция URI. Обратите внимание, что драйвер не обращается к контексту
потока по умолчанию (т.е. <function>stream_context_get_default</function>).
Поддерживаются следующие параметры контекста:
</para>
<table>
<title>Резервные параметры контекста SSL</title>
<tgroup cols="2">
<thead>
<row>
<entry>Параметр драйвера</entry>
<entry>Параметр контекста (запасной вариант)</entry>
</row>
</thead>
<tbody>
<row>
<entry>ca_dir</entry>
<entry>capath</entry>
</row>
<row>
<entry>ca_file</entry>
<entry>cafile</entry>
</row>
<row>
<entry>pem_file</entry>
<entry>local_cert</entry>
</row>
<row>
<entry>pem_pwd</entry>
<entry>passphrase</entry>
</row>
<row>
<entry>weak_cert_validation</entry>
<entry>allow_self_signed</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
Параметр поддерживается для обратной совместимости,
но его следует считать устаревшим.
</para>
</entry>
</row>
@ -549,8 +720,8 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
Путь к сертификату в формате PEM для аутентификации клиента.
</para>
<para>
Если не указан, то используется устаревший параметр
SSL-контекста <literal>"local_cert"</literal>.
Этот параметр является устаревшим псевдонимом
для параметра URI <literal>"tlsCertificateKeyFile"</literal>.
</para>
</entry>
</row>
@ -562,24 +733,8 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
Парольная фраза к PEM-закодированному сертификату (если есть).
</para>
<para>
Если не указан, то используется устаревший параметр
SSL-контекста <literal>"passphrase"</literal>.
</para>
</entry>
</row>
<row>
<entry>context</entry>
<entry><type>resource</type></entry>
<entry>
<para>
<link linkend="context.ssl">Опции SSL-контекста</link>, которые будут
использоваться в качестве запасного варианта
для других параметров драйвера (как указано). Обратите внимание, что
драйвер не имеет отношения к контексту потока по умолчанию.
</para>
<para>
Эта опция поддерживается для обратной совместимости, но ее следует
следует считать устаревшей.
Этот параметр является устаревшим псевдонимом
для параметра URI <literal>"tlsCertificateKeyFilePassword"</literal>.
</para>
</entry>
</row>
@ -591,8 +746,8 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
Отключает проверку сертифика, если &true;. По умолчанию - &false;
</para>
<para>
Если не указан, то используется устаревший параметр
SSL-контекста <literal>"allow_self_signed"</literal>.
Этот параметр является устаревшим псевдонимом
для параметра URI <literal>"tlsAllowInvalidHostnames"</literal>.
</para>
</entry>
</row>
@ -625,6 +780,23 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
</row>
</thead>
<tbody>
<row>
<entry>1.6.0</entry>
<entry>
<para>
Добавлены параметры URI <literal>"retryReads"</literal>, <literal>"tls"</literal>,
<literal>"tlsAllowInvalidCertificates"</literal>,
<literal>"tlsAllowInvalidHostnames"</literal>,
<literal>"tlsCAFile"</literal>,
<literal>"tlsCertificateKeyFile"</literal>,
<literal>"tlsCertificateKeyFilePassword"</literal>, и
<literal>"tlsInsecure"</literal>.
</para>
<para>
Параметр URI <literal>"retryWrites"</literal> по умолчанию &true;.
</para>
</entry>
</row>
<row>
<entry>1.5.0</entry>
<entry>
@ -714,13 +886,13 @@ $manager = new MongoDB\Driver\Manager("mongodb://example.com:27017");
?>
]]>
</programlisting>
<para>
Подключение к автономному узлу MongoDB через доменный сокет Unix. Путь сокета
может содержать специальные символы, например слеши, которые должны закодированы
с помощью <function>rawurlencode</function>.
</para>
<programlisting role="php">
</programlisting>
<para>
Подключение к автономному узлу MongoDB через доменный сокет Unix. Путь сокета
может содержать специальные символы, например слеши, которые должны закодированы
с помощью <function>rawurlencode</function>.
</para>
<programlisting role="php">
<![CDATA[
<?php
@ -728,9 +900,9 @@ $manager = new MongoDB\Driver\Manager("mongodb://" . rawurlencode("/tmp/mongodb-
?>
]]>
</programlisting>
<para>Подключение к набору реплик:</para>
<programlisting role="php">
</programlisting>
<para>Подключение к набору реплик:</para>
<programlisting role="php">
<![CDATA[
<?php
@ -738,9 +910,9 @@ $manager = new MongoDB\Driver\Manager("mongodb://rs1.example.com,rs2.example.com
?>
]]>
</programlisting>
<para>Подключение к сегментированному кластеру (т.е. одну или нескольким экземплярам mongos):</para>
<programlisting role="php">
</programlisting>
<para>Подключение к сегментированному кластеру (т.е. одну или нескольким экземплярам mongos):</para>
<programlisting role="php">
<![CDATA[
<?php
@ -748,9 +920,9 @@ $manager = new MongoDB\Driver\Manager("mongodb://mongos1.example.com,mongos2.exa
?>
]]>
</programlisting>
<para>Подключение к MongoDB с учетными данными аутентификации для конкретного пользователя и базы данных:</para>
<programlisting role="php">
</programlisting>
<para>Подключение к MongoDB с учетными данными аутентификации для конкретного пользователя и базы данных:</para>
<programlisting role="php">
<![CDATA[
<?php
@ -758,18 +930,18 @@ $manager = new MongoDB\Driver\Manager("mongodb://myusername:mypassword@example.c
?>
]]>
</programlisting>
<para>
Подключение к MongoDB с учетными данными аутентификации для конкретного пользователя и базы данных,
где имя пользователя или пароль содержат специальные
символы (e.g. <literal>@</literal>, <literal>:</literal>,
<literal>%</literal>). В следующем примере, строка с паролем
<literal>myp@ss:w%rd</literal> была вручную экранирована; однако
<function>rawurlencode</function> может использоваться для экранирования URI-компонетов,
которые могут содержать специальные символы.
</para>
<programlisting role="php">
</programlisting>
<para>
Подключение к MongoDB с учетными данными аутентификации для конкретного пользователя и базы данных,
где имя пользователя или пароль содержат специальные
символы (e.g. <literal>@</literal>, <literal>:</literal>,
<literal>%</literal>). В следующем примере, строка с паролем
<literal>myp@ss:w%rd</literal> была вручную экранирована; однако
<function>rawurlencode</function> может использоваться для экранирования URI-компонетов,
которые могут содержать специальные символы.
</para>
<programlisting role="php">
<![CDATA[
<?php
@ -777,10 +949,10 @@ $manager = new MongoDB\Driver\Manager("mongodb://myusername:myp%40ss%3Aw%25rd@ex
?>
]]>
</programlisting>
<para>Подключение к MongoDB с аутентификацией X509:</para>
<programlisting role="php">
</programlisting>
<para>Подключение к MongoDB с аутентификацией X509:</para>
<programlisting role="php">
<![CDATA[
<?php
@ -793,8 +965,8 @@ $manager = new MongoDB\Driver\Manager(
);
?>
]]>
</programlisting>
</example>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">