Skip to content

Sync EN: mongodb BSON top-level classes #740

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 BSON top-level classes #740

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
160 changes: 79 additions & 81 deletions reference/mongodb/bson/binary.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: dac7a370d34ddda0a647ea551c28d6e168261613 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: lacatoire Status: ready --><!-- CREDITS: leonardolara -->

<reference xml:id="class.mongodb-bson-binary" 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,12 +11,12 @@
<!-- {{{ MongoDB\BSON\Binary intro -->
<section xml:id="mongodb-bson-binary.intro">
&reftitle.intro;
<para>
<simpara>
Tipo BSON para dados binários (ou seja, array de bytes). Os valores binários também possuem um
subtipo, que é usado para indicar que tipo de dados está no array de bytes.
Os subtipos de zero a 127 são predefinidos ou reservados. Os subtipos de 128 a 255
são definidos pelo usuário.
</para>
</simpara>
</section>
<!-- }}} -->

Expand Down Expand Up @@ -134,101 +134,101 @@
<varlistentry xml:id="mongodb-bson-binary.constants.type-generic">
<term><constant>MongoDB\BSON\Binary::TYPE_GENERIC</constant></term>
<listitem>
<para>Dados binários genéricos.</para>
<simpara>Dados binários genéricos.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-bson-binary.constants.type-function">
<term><constant>MongoDB\BSON\Binary::TYPE_FUNCTION</constant></term>
<listitem>
<para>Função.</para>
<simpara>Função.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-bson-binary.constants.type-old-binary">
<term><constant>MongoDB\BSON\Binary::TYPE_OLD_BINARY</constant></term>
<listitem>
<para>Dados binários genéricos (preterido em favor de <constant>MongoDB\BSON\Binary::TYPE_GENERIC</constant>).</para>
<simpara>Dados binários genéricos (preterido em favor de <constant>MongoDB\BSON\Binary::TYPE_GENERIC</constant>).</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-bson-binary.constants.type-old-uuid">
<term><constant>MongoDB\BSON\Binary::TYPE_OLD_UUID</constant></term>
<listitem>
<para>
<simpara>
Identificador único universal (preterido em favor de
<constant>MongoDB\BSON\Binary::TYPE_UUID</constant>). Ao usar este
tipo, os dados binários precisam ter 16 bytes de comprimento.
</para>
<para>
</simpara>
<simpara>
Historicamente, outros drivers codificaram valores com este tipo com base em suas
convenções de linguagem (ex.: variações little endian / big endian), o que o torna
não portável. A extensão PHP não aplica nenhuma manipulação especial para codificar
ou decodificar dados com este tipo.
</para>
</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-bson-binary.constants.type-uuid">
<term><constant>MongoDB\BSON\Binary::TYPE_UUID</constant></term>
<listitem>
<para>
<simpara>
Identificador único universal. Ao usar este tipo, os dados do binário
devem ter 16 bytes de comprimento e codificados de acordo com a
<link xlink:href="&url.rfc;4122">RFC 4122</link>.
</para>
</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-bson-binary.constants.type-md5">
<term><constant>MongoDB\BSON\Binary::TYPE_MD5</constant></term>
<listitem>
<para>Hash MD5. Ao usar este tipo, os dados do binário devem ter 16 bytes de comprimento.</para>
<simpara>Hash MD5. Ao usar este tipo, os dados do binário devem ter 16 bytes de comprimento.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-bson-binary.constants.type-encrypted">
<term><constant>MongoDB\BSON\Binary::TYPE_ENCRYPTED</constant></term>
<listitem>
<para>Valor criptografado. Este subtipo é usado para criptografia do lado do cliente.</para>
<simpara>Valor criptografado. Este subtipo é usado para criptografia do lado do cliente.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-bson-binary.constants.type-column">
<term><constant>MongoDB\BSON\Binary::TYPE_COLUMN</constant></term>
<listitem>
<para>Dados da coluna. Este subtipo é usado para coleções de séries temporais.</para>
<simpara>Dados da coluna. Este subtipo é usado para coleções de séries temporais.</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-bson-binary.constants.type-sensitive">
<term><constant>MongoDB\BSON\Binary::TYPE_SENSITIVE</constant></term>
<listitem>
<para>
<simpara>
Dados confidenciais. Este subtipo é usado para dados confidenciais que devem ser
excluídos do registro do servidor quando possível.
</para>
</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-bson-binary.constants.type-vector">
<term><constant>MongoDB\BSON\Binary::TYPE_VECTOR</constant></term>
<listitem>
<para>
<simpara>
Dados do vetor. Este subtipo é usado para armazenar dados de vetor de forma eficiente para
uso nas pesquisas de vetor do MongoDB.
</para>
</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="mongodb-bson-binary.constants.type-user-defined">
<term><constant>MongoDB\BSON\Binary::TYPE_USER_DEFINED</constant></term>
<listitem>
<para>
<simpara>
Tipo definido pelo usuário. Enquanto os tipos entre 0 e 127 são predefinidos ou
reservados, os tipos entre 128 e 255 são definidos pelo usuário e podem ser usados ​​para
qualquer coisa.
</para>
</simpara>
</listitem>
</varlistentry>

Expand All @@ -238,66 +238,64 @@

<section role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL mongodb 2.2.0</entry>
<entry>
Adicionada a constante <constant>MongoDB\BSON\Binary::TYPE_VECTOR</constant> e também as funções
<methodname>MongoDB\BSON\Binary::fromVector</methodname>,
<methodname>MongoDB\BSON\Binary::getVectorType</methodname> e
<methodname>MongoDB\BSON\Binary::toArray</methodname>.
</entry>
</row>
&mongodb.changelog.serializable-interface-removed;
<row>
<entry>PECL mongodb 1.17.0</entry>
<entry>
Adicionada a constante <constant>MongoDB\BSON\Binary::TYPE_SENSITIVE</constant>.
</entry>
</row>
<row>
<entry>PECL mongodb 1.12.0</entry>
<entry>
<para>
Implementada a interface <interfacename>Stringable</interfacename> para PHP 8.0+.
</para>
<para>
Adicionada a constante <constant>MongoDB\BSON\Binary::TYPE_COLUMN</constant>.
</para>
</entry>
</row>
<row>
<entry>PECL mongodb 1.7.0</entry>
<entry>
Adicionada a constante <constant>MongoDB\BSON\Binary::TYPE_ENCRYPTED</constant>.
</entry>
</row>
<row>
<entry>PECL mongodb 1.3.0</entry>
<entry>
Implementada a interface <interfacename>MongoDB\BSON\BinaryInterface</interfacename>.
</entry>
</row>
<row>
<entry>PECL mongodb 1.2.0</entry>
<entry>
Implementadas as interfaces <interfacename>Serializable</interfacename> e
<interfacename>JsonSerializable</interfacename>.
</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 2.2.0</entry>
<entry>
Adicionada a constante <constant>MongoDB\BSON\Binary::TYPE_VECTOR</constant> e também as funções
<methodname>MongoDB\BSON\Binary::fromVector</methodname>,
<methodname>MongoDB\BSON\Binary::getVectorType</methodname> e
<methodname>MongoDB\BSON\Binary::toArray</methodname>.
</entry>
</row>
&mongodb.changelog.serializable-interface-removed;
<row>
<entry>PECL mongodb 1.17.0</entry>
<entry>
Adicionada a constante <constant>MongoDB\BSON\Binary::TYPE_SENSITIVE</constant>.
</entry>
</row>
<row>
<entry>PECL mongodb 1.12.0</entry>
<entry>
<simpara>
Implementada a interface <interfacename>Stringable</interfacename> para PHP 8.0+.
</simpara>
<simpara>
Adicionada a constante <constant>MongoDB\BSON\Binary::TYPE_COLUMN</constant>.
</simpara>
</entry>
</row>
<row>
<entry>PECL mongodb 1.7.0</entry>
<entry>
Adicionada a constante <constant>MongoDB\BSON\Binary::TYPE_ENCRYPTED</constant>.
</entry>
</row>
<row>
<entry>PECL mongodb 1.3.0</entry>
<entry>
Implementada a interface <interfacename>MongoDB\BSON\BinaryInterface</interfacename>.
</entry>
</row>
<row>
<entry>PECL mongodb 1.2.0</entry>
<entry>
Implementadas as interfaces <interfacename>Serializable</interfacename> e
<interfacename>JsonSerializable</interfacename>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

</partintro>
Expand Down
36 changes: 17 additions & 19 deletions reference/mongodb/bson/binaryinterface.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: 4639881688d3faaf0073ad71fe0a4b730aea15a0 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: lacatoire Status: ready --><!-- CREDITS: leonardolara -->

<reference xml:id="class.mongodb-bson-binaryinterface" 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 @@ -9,10 +9,10 @@
<partintro>
<section xml:id="mongodb-bson-binaryinterface.intro">
&reftitle.intro;
<para>
<simpara>
Esta interface é implementada por <classname>MongoDB\BSON\Binary</classname>
para ser usada como um parâmetro, um retorno, ou um tipo de propriedade em classes do usuário.
</para>
</simpara>
</section>

<section xml:id="mongodb-bson-binaryinterface.synopsis">
Expand All @@ -31,22 +31,20 @@

<section role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&mongodb.changelog.tentative-return-types-enforced;
&mongodb.changelog.tentative-return-types;
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&mongodb.changelog.tentative-return-types-enforced;
&mongodb.changelog.tentative-return-types;
</tbody>
</tgroup>
</informaltable>
</section>
</partintro>

Expand Down
46 changes: 22 additions & 24 deletions reference/mongodb/bson/dbpointer.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: 4639881688d3faaf0073ad71fe0a4b730aea15a0 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: lacatoire Status: ready --><!-- CREDITS: leonardolara -->

<reference xml:id="class.mongodb-bson-dbpointer" 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,12 +11,12 @@
<!-- {{{ MongoDB\BSON\DBPointer intro -->
<section xml:id="mongodb-bson-dbpointer.intro">
&reftitle.intro;
<para>
<simpara>
Tipo BSON para o tipo "DBPointer". Este tipo BSON está preterido e esta
classe não pode ser instanciada. Ele será criado a partir de um tipo BSON
DBPointer durante a conversão de BSON para PHP e também pode ser convertida de volta para
BSON durante o armazenamento de documentos no banco de dados.
</para>
</simpara>
</section>
<!-- }}} -->

Expand Down Expand Up @@ -57,27 +57,25 @@

<section role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&mongodb.changelog.serializable-interface-removed;
<row>
<entry>PECL mongodb 1.12.0</entry>
<entry>
Implementa <interfacename>Stringable</interfacename> para PHP 8.0+.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&mongodb.changelog.serializable-interface-removed;
<row>
<entry>PECL mongodb 1.12.0</entry>
<entry>
Implementa <interfacename>Stringable</interfacename> para PHP 8.0+.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

</partintro>
Expand Down
Loading
Loading