Skip to content

Sync EN: mongodb driver Manager #748

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
lacatoire wants to merge 1 commit into from
Closed

Sync EN: mongodb driver Manager #748

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions reference/mongodb/mongodb/driver/manager.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: lacatoire Status: ready --><!-- CREDITS: leonardolara -->

<reference xml:id="class.mongodb-driver-manager" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

Expand All @@ -11,21 +11,21 @@
<!-- {{{ MongoDB\Driver\Manager intro -->
<section xml:id="mongodb-driver-manager.intro">
&reftitle.intro;
<para>
<simpara>
A classe <classname>MongoDB\Driver\Manager</classname> é o principal ponto de entrada
para a extensão. É responsável por manter conexões com o MongoDB
(seja ele servidor independente, conjunto de réplicas ou cluster fragmentado).
</para>
<para>
</simpara>
<simpara>
Nenhuma conexão com o MongoDB é feita ao instanciar a classe.
Isso significa que o objeto <classname>MongoDB\Driver\Manager</classname> sempre pode ser
construído, mesmo que um ou mais servidores MongoDB estejam inativos.
</para>
<para>
</simpara>
<simpara>
Qualquer escrita ou consulta pode lançar exceções de conexão, pois as conexões são criadas lentamente.
Um servidor MongoDB também pode ficar indisponível durante a vida útil do script.
Portanto, é importante que todas as ações no objeto Manager sejam agrupadas em instruções try/catch.
</para>
</simpara>
</section>
<!-- }}} -->

Expand Down Expand Up @@ -57,13 +57,13 @@

<example>
<title>Exemplo básico de <function>MongoDB\Driver\Manager::__construct</function></title>
<para>
<simpara>
A função <function>var_dump</function> executada em um
objeto <classname>MongoDB\Driver\Manager</classname> irá mostrar vários
detalhes sobre o gerenciador do driver que não são normalmente expostas.
Isso pode ser útil para depurar como o driver visualiza a configuração do MongoDB e
quais opções são usadas.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
Expand Down
14 changes: 7 additions & 7 deletions reference/mongodb/mongodb/driver/manager/addsubscriber.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b817c8855866acbb37c260cbc62235b8d2d88ea1 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: lacatoire Status: ready --><!-- CREDITS: leonardolara -->

<refentry xml:id="mongodb-driver-manager.addsubscriber" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -13,10 +13,10 @@
<modifier>final</modifier> <modifier>public</modifier> <type>void</type><methodname>MongoDB\Driver\Manager::addSubscriber</methodname>
<methodparam><type>MongoDB\Driver\Monitoring\Subscriber</type><parameter>subscriber</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Inscreve um assinante de evento de monitoramento neste gerenciador.
O assinante será notificado de todos os eventos deste gerenciador.
</para>
</simpara>
<note>
<simpara>
Se o <parameter>subscriber</parameter> já estiver inscrito neste
Expand All @@ -33,19 +33,19 @@
<varlistentry>
<term><parameter>subscriber</parameter> (<type>MongoDB\Driver\Monitoring\Subscriber</type>)</term>
<listitem>
<para>
<simpara>
Um assinante de evento de monitoramento para increver-se neste gerenciador.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>

<refsect1 role="errors">
Expand Down
140 changes: 69 additions & 71 deletions reference/mongodb/mongodb/driver/manager/createclientencryption.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc6f9ee922cc02771942f435f66fbd008bf5788d Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: lacatoire Status: ready --><!-- CREDITS: leonardolara -->

<refentry xml:id="mongodb-driver-manager.createclientencryption" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -13,9 +13,9 @@
<modifier>final</modifier> <modifier>public</modifier> <type>MongoDB\Driver\ClientEncryption</type><methodname>MongoDB\Driver\Manager::createClientEncryption</methodname>
<methodparam><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Constrói um novo objeto <classname>MongoDB\Driver\ClientEncryption</classname> com as opções especificadas.
</para>
</simpara>
</refsect1>

<refsect1 role="parameters">
Expand Down Expand Up @@ -51,9 +51,9 @@

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna uma nova instância de <classname>MongoDB\Driver\ClientEncryption</classname>.
</para>
</simpara>
</refsect1>

<refsect1 role="errors">
Expand All @@ -66,72 +66,70 @@

<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL mongodb 1.16.0</entry>
<entry>
<para>
O provedor AWS KMS para criptografia do lado do cliente agora aceita uma
opção <literal>"sessionToken"</literal>, que pode ser usada para
autenticação com credenciais temporárias da AWS.
</para>
<para>
Adicionado <literal>"tlsDisableOCSPEndpointCheck"</literal> à opção
<literal>"tlsOptions"</literal>.
</para>
<para>
Se um documento vazio for especificado para o provedor KMS <literal>"azure"</literal> ou
<literal>"gcp"</literal>, o driver tentará
configurar o provedor usando
<link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Credenciais Automáticas</link>.
</para>
</entry>
</row>
<row>
<entry>PECL mongodb 1.15.0</entry>
<entry>
<para>
Se um documento vazio for especificado para o provedor KMS <literal>"aws"</literal>,
o driver tentará configurar o provedor usando
<link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Credenciais Automáticas</link>.
</para>
</entry>
</row>
<row>
<entry>PECL mongodb 1.12.0</entry>
<entry>
<para>
O KMIP agora é suportado como um provedor KMS para criptografia do lado do cliente e
pode ser configurado na opção <literal>"kmsProviders"</literal>.
</para>
<para>
Adicionada a opção <literal>"tlsOptions"</literal>.
</para>
</entry>
</row>
<row>
<entry>PECL mongodb 1.10.0</entry>
<entry>
O Azure e o GCP agora são suportados como provedores KMS para criptografia
do lado do cliente e podem ser configurados na
opção <literal>"kmsProviders"</literal>. Strings codificadas em Base64 agora são
aceitas como uma alternativa ao <classname>MongoDB\BSON\Binary</classname>
para opções dentro de <literal>"kmsProviders"</literal>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL mongodb 1.16.0</entry>
<entry>
<simpara>
O provedor AWS KMS para criptografia do lado do cliente agora aceita uma
opção <literal>"sessionToken"</literal>, que pode ser usada para
autenticação com credenciais temporárias da AWS.
</simpara>
<simpara>
Adicionado <literal>"tlsDisableOCSPEndpointCheck"</literal> à opção
<literal>"tlsOptions"</literal>.
</simpara>
<simpara>
Se um documento vazio for especificado para o provedor KMS <literal>"azure"</literal> ou
<literal>"gcp"</literal>, o driver tentará
configurar o provedor usando
<link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Credenciais Automáticas</link>.
</simpara>
</entry>
</row>
<row>
<entry>PECL mongodb 1.15.0</entry>
<entry>
<simpara>
Se um documento vazio for especificado para o provedor KMS <literal>"aws"</literal>,
o driver tentará configurar o provedor usando
<link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Credenciais Automáticas</link>.
</simpara>
</entry>
</row>
<row>
<entry>PECL mongodb 1.12.0</entry>
<entry>
<simpara>
O KMIP agora é suportado como um provedor KMS para criptografia do lado do cliente e
pode ser configurado na opção <literal>"kmsProviders"</literal>.
</simpara>
<simpara>
Adicionada a opção <literal>"tlsOptions"</literal>.
</simpara>
</entry>
</row>
<row>
<entry>PECL mongodb 1.10.0</entry>
<entry>
O Azure e o GCP agora são suportados como provedores KMS para criptografia
do lado do cliente e podem ser configurados na
opção <literal>"kmsProviders"</literal>. Strings codificadas em Base64 agora são
aceitas como uma alternativa ao <classname>MongoDB\BSON\Binary</classname>
para opções dentro de <literal>"kmsProviders"</literal>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="seealso">
Expand Down
Loading
Loading