From 9b5c83eb066d0bec4009b2bd9cfd308566772d97 Mon Sep 17 00:00:00 2001 From: PhilDaiguille Date: Sun, 10 May 2026 11:01:08 +0200 Subject: [PATCH] [Sync ES] Update XML documentation for MongoDB methods to improve clarity and consistency --- language/types/type-juggling.xml | 332 +++++++++--------- language/types/void.xml | 50 ++- .../bson/utcdatetime/jsonserialize.xml | 16 +- .../mongodb/bson/utcdatetime/todatetime.xml | 19 +- .../bson/utcdatetime/todatetimeimmutable.xml | 16 +- .../mongodb/bson/utcdatetime/tostring.xml | 12 +- .../bson/utcdatetimeinterface/todatetime.xml | 14 +- .../todatetimeimmutable.xml | 11 +- .../bson/utcdatetimeinterface/tostring.xml | 12 +- reference/mongodb/functions/bson/fromjson.xml | 73 ++-- reference/mongodb/functions/bson/fromphp.xml | 76 ++-- .../bson/tocanonicalextendedjson.xml | 71 ++-- reference/mongodb/functions/bson/tojson.xml | 89 ++--- reference/mongodb/functions/bson/tophp.xml | 132 +++---- .../functions/bson/torelaxedextendedjson.xml | 67 ++-- .../driver/monitoring/addsubscriber.xml | 31 +- .../driver/monitoring/removesubscriber.xml | 26 +- .../mongodb/mongodb/driver/bulkwrite.xml | 75 ++-- .../mongodb/driver/bulkwrite/construct.xml | 126 +++---- .../mongodb/driver/bulkwrite/count.xml | 59 ++-- .../mongodb/driver/bulkwrite/delete.xml | 91 +++-- .../mongodb/driver/bulkwrite/insert.xml | 77 ++-- .../mongodb/driver/bulkwrite/update.xml | 210 +++++------ .../mongodb/driver/bulkwritecommand.xml | 71 ++-- .../driver/bulkwritecommand/construct.xml | 82 ++--- .../mongodb/driver/bulkwritecommand/count.xml | 24 +- .../driver/bulkwritecommand/deletemany.xml | 25 +- .../driver/bulkwritecommand/deleteone.xml | 26 +- .../driver/bulkwritecommand/insertone.xml | 31 +- .../driver/bulkwritecommand/replaceone.xml | 51 +-- .../driver/bulkwritecommand/updatemany.xml | 55 +-- .../driver/bulkwritecommand/updateone.xml | 70 ++-- .../mongodb/driver/bulkwritecommandresult.xml | 20 +- .../getdeletedcount.xml | 13 +- .../getdeleteresults.xml | 21 +- .../getinsertedcount.xml | 17 +- .../mongodb/driver/clientencryption.xml | 209 ++++++----- reference/mongodb/mongodb/driver/command.xml | 23 +- reference/mongodb/mongodb/driver/cursor.xml | 216 ++++++------ reference/mongodb/mongodb/driver/cursorid.xml | 91 +++-- .../mongodb/driver/cursorinterface.xml | 67 ++-- reference/mongodb/mongodb/driver/manager.xml | 48 +-- reference/mongodb/mongodb/driver/query.xml | 16 +- reference/mongodb/mongodb/driver/server.xml | 92 +++-- .../mongodb/mongodb/driver/serverapi.xml | 36 +- .../mongodb/driver/serverdescription.xml | 47 +-- reference/mongodb/mongodb/driver/session.xml | 45 +-- .../mongodb/driver/topologydescription.xml | 30 +- 48 files changed, 1564 insertions(+), 1547 deletions(-) diff --git a/language/types/type-juggling.xml b/language/types/type-juggling.xml index 935254b81..f0d030d51 100644 --- a/language/types/type-juggling.xml +++ b/language/types/type-juggling.xml @@ -1,33 +1,34 @@ - - + + Manipulación de tipos - PHP no requiere una definición de tipo explícita en las declaraciones de variables. - En este caso, el tipo de una variable se determina en función del valor que tiene almacenado. - Es decir, si una string se asigna a la variable - $var, entonces $var es de tipo - string. Si después se asigna un valor int a - $var, será de tipo int. + PHP no requiere una definición explícita de tipo en la declaración de variables. + En este caso, el tipo de una variable se determina por el valor que almacena. + Es decir, si se asigna un string a la variable + $var, entonces $var será de tipo + string. Si posteriormente se asigna un valor de tipo + int a $var, pasará a ser de tipo + int. - PHP puede intentar convertir el tipo de un valor en otro automáticamente - en ciertos contextos. Los diferentes contextos que existen son: + PHP puede intentar convertir automáticamente el tipo de un valor a otro en + ciertos contextos. Los diferentes contextos que existen son: Numérico - String + Cadena Lógico - Integral y string + Entero y cadena Comparativo @@ -40,51 +41,54 @@ - Cuando un valor necesita ser interpretado como un tipo diferente, - el valor en sí no cambia de tipo. + Cuando un valor necesita ser interpretado como un tipo diferente, el valor + en sí no cambia de tipo. - Para forzar una variable a ser evaluada como un tipo particular, ver la - sección sobre casting de tipo. - Para cambiar el tipo de una variable, ver la función settype. + Para forzar a que una variable sea evaluada como un tipo determinado, consulte + la sección sobre moldeado de tipos. + Para cambiar el tipo de una variable, consulte la función + settype. Contextos numéricos - Este es el contexto al utilizar un + Este es el contexto cuando se utiliza un operador aritmético. - En este contexto, si uno de los operandos es un float (o - no interpretable como int), ambos operandos se interpretan - como floats, y el resultado será un float. - De lo contrario, los operandos se interpretan como ints, - y el resultado será también un int. - A partir de PHP 8.0.0, si uno de los operandos no puede ser interpretado como - TypeError se lanza. + En este contexto, si alguno de los operandos es de tipo float + (o no puede interpretarse como un int), ambos operandos se + interpretarán como floats, y el resultado también será un + float. De lo contrario, los operandos se interpretarán como + ints, y el resultado también será un int. + A partir de PHP 8.0.0, si uno de los operandos no puede interpretarse, se + lanzará un TypeError. - Contextos string + Contextos de cadena - Este es el contexto al utilizar echo, - print, la interpolación de cadenas de caracteres, o el - operador de concatenación - para las cadenas de caracteres. + Este es el contexto cuando se utiliza echo, + print, + interpolación de cadena, + o el + operador de concatenación de + cadena. - En este contexto, el valor se interpretará como una string. - Si el valor no puede ser interpretado, se levanta una - TypeError. - Anterior a PHP 7.4.0, se generaba una E_RECOVERABLE_ERROR. + En este contexto, el valor se interpretará como string. + Si el valor no puede interpretarse, se lanzará un + TypeError. Antes de PHP 7.4.0, se generaba un + E_RECOVERABLE_ERROR. @@ -92,31 +96,31 @@ Contextos lógicos - Este es el contexto al utilizar declaraciones condicionales, - el operador ternario, + Este es el contexto cuando se utilizan sentencias condicionales, el + operador ternario, o un operador lógico. - En este contexto, el valor se interpretará como un bool. + En este contexto, el valor se interpretará como bool. - Contextos integrales y string + Contextos entero y cadena - Este es el contexto al utilizar un - operador bit a bit. + Este es el contexto cuando se utilizan + operadores a nivel de bits. - En este contexto, si todos los operandos son de tipo string - entonces el resultado será también una string. + En este contexto, si todos los operandos son de tipo string, + el resultado también será un string. De lo contrario, los operandos se interpretarán como ints, - y el resultado será también un int. - A partir de PHP 8.0.0, si uno de los operandos no puede ser interpretado, - se lanza una TypeError. + y el resultado también será un int. + A partir de PHP 8.0.0, si uno de los operandos no puede interpretarse, se + lanzará un TypeError. @@ -124,42 +128,43 @@ Contextos comparativos - Este es el contexto al utilizar un + Este es el contexto cuando se utiliza un operador de comparación. - Las conversiones de tipos que se producen en este contexto se explican - en el tabla - Comparación con varios tipos. + Las conversiones de tipo que ocurren en este contexto se explican en la + tabla de Comparación con diversos tipos + tabla. - Contextos de funciones + Contextos de función - Este es el contexto cuando un valor se pasa a un parámetro o propiedad - tipada o se devuelve desde una función que declara un tipo de retorno. + Este es el contexto cuando un valor se pasa a un parámetro tipado, propiedad + o se devuelve desde una función que declara un tipo de retorno. - En este contexto, el valor debe ser una valor del tipo. - Existen dos excepciones, la primera es la siguiente: si el valor es de - tipo int y el tipo declarado es float, entonces - el entero se convierte en número de coma flotante. - La segunda es: si el tipo declarado es un tipo escalar - - , el valor es convertible en un tipo escalar, y el modo de tipado coercitivo - está activo (por omisión), el valor puede ser convertido en un valor escalar aceptado. - Ver a continuación para una descripción de este comportamiento. + En este contexto, el valor debe ser de ese tipo. Existen dos excepciones: + la primera es: si el valor es de tipo int y el tipo declarado + es float, entonces el entero se convierte en un número de + punto flotante. La segunda es: si el tipo declarado es un tipo + escalar + + , el valor es convertible a un tipo escalar y el modo de tipado coercitivo + está activo (por omisión), el valor puede convertirse en un valor escalar + aceptado. Consulte a continuación para obtener una descripción de este + comportamiento. - Las funciones internas - fuerzan automáticamente &null; a los tipos escalares, - este comportamiento está OBSOLETO a partir de PHP 8.1.0. + Las funciones internas convierten + automáticamente &null; a tipos escalares; este comportamiento está + DEPRECADO a partir de PHP 8.1.0. @@ -168,39 +173,40 @@ - Tipo de declaración bool: valor se interpreta como bool. + Declaración de tipo bool: el valor se interpreta como + bool. - Tipo de declaración int: valor se interpreta como int - si la conversión está bien definida. Por ejemplo, la cadena es - numérica. + Declaración de tipo int: el valor se interpreta como + int si la conversión está bien definida. Por ejemplo, la + cadena es numérica. - Tipo de declaración float: valor se interpreta como float - si la conversión está bien definida. Por ejemplo, la cadena es - numérica. + Declaración de tipo float: el valor se interpreta como + float si la conversión está bien definida. Por ejemplo, la + cadena es numérica. - Tipo de declaración string: valor se interpreta como string. + Declaración de tipo string: el valor se interpreta como + string. - Tipado coercitivo con uniones de tipo + Tipado coercitivo con tipos de unión - Cuando strict_types no está activado, las - declaraciones de tipo escalar están sujetas a restricciones de tipo - implícitas limitadas. - Si el tipo exacto del valor no forma parte de la unión, el tipo objetivo - se elige en el siguiente orden de preferencia: + Cuando strict_types no está habilitado, las + declaraciones de tipo escalar están sujetas a conversiones implícitas + limitadas. Si el tipo exacto del valor no es parte de la unión, entonces + el tipo objetivo se elige en el siguiente orden de preferencia: @@ -225,53 +231,55 @@ - Si el tipo existe en la unión y el valor puede ser forzado a - este tipo utilizando la semántica de verificación de tipo existente de PHP, entonces el tipo es elegido. + Si el tipo existe en la unión y el valor puede ser coercionado al tipo + bajo la semántica de verificación de tipos existente de PHP, entonces se + elige el tipo. De lo contrario, se prueba con el siguiente tipo. - A título de excepción, si el valor es una cadena y int y float forman - ambos parte de la unión, el tipo preferido se determina por la - semántica de cadena numérica. - Por ejemplo, para "42" int es elegido, - mientras que para "42.0" float es elegido. + Como excepción, si el valor es una cadena y tanto int como float son parte + de la unión, el tipo preferido se determina por la semántica de + cadena numérica + existente. Por ejemplo, para "42" se elige + int, mientras que para "42.0" se elige + float. - Los tipos que no forman parte de la lista de preferencias anterior no - son objetivos admisibles para la coerción implícita. En particular, - ninguna restricción implícita a los tipos null, false y - true se produce. + Los tipos que no forman parte de la lista de preferencias anterior no son + objetivos elegibles para coerción implícita. En particular, no ocurren + coerciones implícitas a los tipos null, false + y true. - Ejemplo de tipos restringidos a una parte del tipo de la unión + Ejemplo de tipos siendo coercionados a un tipo parte de la unión 42 // tipo exacto "42" --> "42" // tipo exacto -new ObjectWithToString --> "Result of __toString()" - // objeto nunca compatible con int, recurrir a string +new ObjectWithToString --> "Resultado de __toString()" + // objeto nunca compatible con int, retrocede a string 42.0 --> 42 // float compatible con int 42.1 --> 42 // float compatible con int -1e100 --> "1.0E+100" // float demasiado grande para el tipo int, recurrir a string -INF --> "INF" // float demasiado grande para el tipo int, recurrir a string +1e100 --> "1.0E+100" // float demasiado grande para int, retrocede a string +INF --> "INF" // float demasiado grande para int, retrocede a string true --> 1 // bool compatible con int [] --> TypeError // array no compatible con int o string // int|float|bool -"45" --> 45 // int string numérico -"45.0" --> 45.0 // float string numérico +"45" --> 45 // cadena numérica int +"45.0" --> 45.0 // cadena numérica float -"45X" --> true // no string numérico, recurrir a bool -"" --> false // no string numérico, recurrir a bool -"X" --> true // no string numérico, recurrir a bool +"45X" --> true // no es cadena numérica, retrocede a bool +"" --> false // no es cadena numérica, retrocede a bool +"X" --> true // no es cadena numérica, retrocede a bool [] --> TypeError // array no compatible con int, float o bool ?> ]]> @@ -282,20 +290,20 @@ true --> 1 // bool compatible con int - Cast de tipo + Moldeado de tipos - El casting de tipo convierte el valor a un tipo dado escribiendo el tipo - entre paréntesis antes del valor a convertir. + El moldeado de tipos convierte el valor a un tipo elegido escribiendo el + tipo entre paréntesis antes del valor a convertir. - Conversión de tipo + Moldeado de tipos @@ -304,59 +312,66 @@ var_dump($bar); - Los casts permitidos son: + Los moldeados permitidos son: - (int) - cast en int - (bool) - cast en bool - (float) - cast en float - (string) - cast en string - (array) - cast en array - (object) - cast en object - (unset) - cast en NULL + (int) - moldear a int + (bool) - moldear a bool + (float) - moldear a float + (string) - moldear a string + (array) - moldear a array + (object) - moldear a object + (unset) - moldear a NULL + + El moldeado (void) + también está disponible a partir de PHP 8.5.0, pero no es una conversión + de valor. Se utiliza como una sentencia para descartar explícitamente el + resultado de una expresión. + + - (integer) es un alias del cast (int). - (boolean) es un alias del cast (bool). - (binary) es un alias del cast (string). + (integer) es un alias del moldeado (int). + (boolean) es un alias del moldeado (bool). + (binary) es un alias del moldeado (string). (double) y (real) son alias del - cast (float). - Estos casts no utilizan el nombre de tipo canónico y están obsoletos a partir de PHP 8.5.0. + moldeado (float). Estos moldeados no utilizan el nombre + canónico del tipo y están deprecados a partir de PHP 8.5.0. - El alias de cast (real) está obsoleto a partir de PHP 7.4.0 - y eliminado a partir de PHP 8.0.0. + El alias de moldeado (real) fue deprecado a partir de + PHP 7.4.0 y eliminado a partir de PHP 8.0.0. - El cast (unset) fue declarado obsoleto a partir de PHP 7.2.0. - A notar que el cast (unset) es idéntico a asignar el - valor NULL a una variable o una llamada. - El cast (unset) es eliminado a partir de PHP 8.0.0. + El moldeado (unset) fue deprecado a partir de PHP 7.2.0. + Tenga en cuenta que el moldeado (unset) es igual a + asignar el valor NULL a la variable o llamada. + El moldeado (unset) fue eliminado a partir de PHP 8.0.0. - El cast (binary) y el prefijo b - existen únicamente para la compatibilidad ascendente. Actualmente - (binary) y (string) son idénticos, - pero esto puede cambiar: no se debe contar con ello. + El moldeado (binary) y el prefijo b + existen para soporte futuro. Actualmente (binary) y + (string) son idénticos, sin embargo esto puede cambiar y + no debe ser utilizado como dependencia. - Los espacios en blanco se ignoran dentro de los paréntesis de un cast. - Así, los dos casts siguientes son equivalentes: + Los espacios en blanco se ignoran dentro de los paréntesis de un moldeado. + Por lo tanto, los siguientes dos moldeados son equivalentes: - Cast de strings literales y variables en + Moldeando literales strings y variables a strings binarios: @@ -380,7 +395,7 @@ $foo = ( int ) $bar; ]]> @@ -388,22 +403,22 @@ $binary = b"binary string"; - En lugar de transtypar una variable en una string, también es posible - rodear la variable con comillas dobles. + En lugar de moldear una variable a un string, también es + posible encerrar la variable entre comillas dobles. - Diferentes mecanismos de conversión + Diferentes mecanismos de moldeado ]]> @@ -411,35 +426,36 @@ if ($fst === $str) { - Lo que ocurrirá exactamente al transtypar entre ciertos tipos - no es necesariamente evidente. Para más información, ver estas secciones: + Puede que no sea obvio exactamente qué ocurrirá al moldear entre ciertos + tipos. Para más información, consulte estas secciones: - Convertir en boolean - Convertir en integer - Convertir en float - Convertir en string - Convertir en array - Convertir en object - Convertir en resource - Convertir en NULL - Las tablas de comparación de tipo + Conversión a booleano + Conversión a entero + Conversión a float + Conversión a cadena + Conversión a array + Conversión a objeto + Conversión a recurso + Conversión a NULL + Descartar un valor con (void) + Las tablas de comparación de tipos - Como PHP soporta la indexación en las strings - mediante posiciones utilizando la misma sintaxis que la indexación de array, - el siguiente ejemplo es válido para todas las versiones de PHP: + Dado que PHP soporta indexación en strings mediante offsets + utilizando la misma sintaxis que el indexado en array, el + siguiente ejemplo se cumple para todas las versiones de PHP: - Uso de un índice de array con una cadena + Usando offset de array con una cadena ]]> @@ -447,8 +463,8 @@ echo $a; // bar - Ver la sección sobre el acceso - a las cadenas por caracter para más información. + Consulte la sección titulada Acceso a cadena por carácter + para más información. diff --git a/language/types/void.xml b/language/types/void.xml index 02b08db09..b728ab486 100644 --- a/language/types/void.xml +++ b/language/types/void.xml @@ -1,24 +1,56 @@ - - + + Void - void es una declaración de tipo de retorno únicamente, indicando que la función - no devuelve ningún valor, pero que la función puede terminar de todos modos. - Por lo tanto, no puede formar parte de una declaración de - tipo de unión + void es un tipo de declaración de retorno que indica que la + función no devuelve ningún valor, pero la función aún puede terminar. + Por lo tanto, no puede formar parte de una + declaración de tipo unión. Disponible a partir de PHP 7.1.0. - Aunque una función tenga un tipo de retorno void, siempre - devolverá un valor, este valor siempre es &null;. + Incluso si una función tiene un tipo de retorno void, seguirá + devolviendo un valor; este valor siempre es &null;. + + Descartar un valor con <literal>(void)</literal> + + + La sintaxis (void) puede usarse para descartar + explícitamente el resultado de una expresión. Esto es útil para indicar que + ignorar un valor de retorno es intencional, especialmente al llamar a una + función o método marcado con el atributo NoDiscard. + + + + A diferencia de otros moldes, (void) no convierte el + valor a otro tipo ni produce un valor. Es una sentencia y no puede usarse + como parte de una expresión. + + + + Descartar un valor de retorno + + +]]> + + + diff --git a/reference/mongodb/bson/utcdatetime/jsonserialize.xml b/reference/mongodb/bson/utcdatetime/jsonserialize.xml index b90b2017a..d8e17d8b2 100644 --- a/reference/mongodb/bson/utcdatetime/jsonserialize.xml +++ b/reference/mongodb/bson/utcdatetime/jsonserialize.xml @@ -1,12 +1,10 @@ - - + - MongoDB\BSON\UTCDateTime::jsonSerialize - Devuelve una representación que puede ser convertida en JSON + Devuelve una representación que puede convertirse a JSON @@ -24,11 +22,11 @@ &reftitle.returnvalues; - - Devuelve datos que pueden ser serializados por json_encode - para producir una representación JSON extendida de + + Devuelve datos que pueden ser serializados por json_encode para + producir una representación JSON extendida de la MongoDB\BSON\UTCDateTime. - + &mongodb.note.extended-json; @@ -46,7 +44,7 @@ json_encode MongoDB\BSON\toCanonicalExtendedJSON MongoDB\BSON\toRelaxedExtendedJSON - MongoDB JSON Extendido + MongoDB Extended JSON diff --git a/reference/mongodb/bson/utcdatetime/todatetime.xml b/reference/mongodb/bson/utcdatetime/todatetime.xml index 92a5d440a..34bdf8daa 100644 --- a/reference/mongodb/bson/utcdatetime/todatetime.xml +++ b/reference/mongodb/bson/utcdatetime/todatetime.xml @@ -1,8 +1,6 @@ - - + - MongoDB\BSON\UTCDateTime::toDateTime @@ -12,7 +10,7 @@ &reftitle.description; - final public DateTimeMongoDB\BSON\UTCDatetime::toDateTime + final public DateTimeMongoDB\BSON\UTCDateTime::toDateTime @@ -24,10 +22,11 @@ &reftitle.returnvalues; - - Devuelve la representación DateTime de este UTCDateTime. - El DateTime devuelto utilizará el huso horario UTC. - + + Devuelve la representación DateTime de este + UTCDateTime. El DateTime devuelto utilizará la zona + horaria UTC. + @@ -40,7 +39,7 @@ &reftitle.examples; - Ejemplo con <function>MongoDB\BSON\UTCDatetime::toDateTime</function> + Ejemplo de <function>MongoDB\BSON\UTCDatetime::toDateTime</function> MongoDB\BSON\UTCDateTime::toDateTimeImmutable - El tipo BSON : Date + Tipos BSON: Fecha diff --git a/reference/mongodb/bson/utcdatetime/todatetimeimmutable.xml b/reference/mongodb/bson/utcdatetime/todatetimeimmutable.xml index 803f79aac..998fc07a8 100644 --- a/reference/mongodb/bson/utcdatetime/todatetimeimmutable.xml +++ b/reference/mongodb/bson/utcdatetime/todatetimeimmutable.xml @@ -1,10 +1,10 @@ - + MongoDB\BSON\UTCDateTime::toDateTimeImmutable - Devuelve la representación DateTimeImmutable de esta UTCDateTime + Devuelve la representación DateTimeImmutable de este UTCDateTime @@ -22,11 +22,11 @@ &reftitle.returnvalues; - - Devuelve la representación DateTimeImmutable de esta - UTCDateTime. El DateTimeImmutable devuelto utilizará - el huso horario UTC. - + + Devuelve la representación DateTimeImmutable de este + UTCDateTime. El DateTimeImmutable devuelto utilizará la zona + horaria UTC. + @@ -73,7 +73,7 @@ object(DateTimeZone)#3 (2) { &reftitle.seealso; MongoDB\BSON\UTCDateTime::toDateTime - Tipos BSON : Date + Tipos BSON: Fecha diff --git a/reference/mongodb/bson/utcdatetime/tostring.xml b/reference/mongodb/bson/utcdatetime/tostring.xml index 21708b2a2..303ab135c 100644 --- a/reference/mongodb/bson/utcdatetime/tostring.xml +++ b/reference/mongodb/bson/utcdatetime/tostring.xml @@ -1,8 +1,6 @@ - - + - MongoDB\BSON\UTCDateTime::__toString @@ -24,15 +22,15 @@ &reftitle.returnvalues; - + Devuelve la representación en forma de string de este UTCDateTime. - + &reftitle.examples; - Ejemplo con <function>MongoDB\BSON\UTCDatetime::__toString</function> + Ejemplo de <function>MongoDB\BSON\UTCDateTime::__toString</function> &reftitle.seealso; - BSON Types: Date + Tipos BSON: Fecha diff --git a/reference/mongodb/bson/utcdatetimeinterface/todatetime.xml b/reference/mongodb/bson/utcdatetimeinterface/todatetime.xml index 80cb200c5..a4fb011d1 100644 --- a/reference/mongodb/bson/utcdatetimeinterface/todatetime.xml +++ b/reference/mongodb/bson/utcdatetimeinterface/todatetime.xml @@ -1,12 +1,10 @@ - - + - MongoDB\BSON\UTCDateTimeInterface::toDateTime - Devuelve la representación DateTime de UTCDateTimeInterface + Devuelve la representación DateTime de esta UTCDateTimeInterface @@ -24,11 +22,11 @@ &reftitle.returnvalues; - + Devuelve la representación DateTime de esta - UTCDateTimeInterface. El DateTime debería utilizar - el huso horario UTC. - + UTCDateTimeInterface. El DateTime devuelto debe usar + la zona horaria UTC. + diff --git a/reference/mongodb/bson/utcdatetimeinterface/todatetimeimmutable.xml b/reference/mongodb/bson/utcdatetimeinterface/todatetimeimmutable.xml index 8cf908d81..bed7ccc78 100644 --- a/reference/mongodb/bson/utcdatetimeinterface/todatetimeimmutable.xml +++ b/reference/mongodb/bson/utcdatetimeinterface/todatetimeimmutable.xml @@ -1,11 +1,10 @@ - + - MongoDB\BSON\UTCDateTimeInterface::toDateTimeImmutable - Devuelve la representación DateTimeImmutable de esta UTCDateTimeInterface + Devuelve la representación DateTimeImmutable de esta interfaz UTCDateTimeInterface @@ -23,10 +22,10 @@ &reftitle.returnvalues; - + Devuelve la representación DateTimeImmutable de esta - UTCDateTimeInterface. La DateTimeImmutable devuelta utilizará la zona horaria UTC. - + interfaz UTCDateTimeInterface. El DateTimeImmutable devuelto utilizará la zona horaria UTC. + diff --git a/reference/mongodb/bson/utcdatetimeinterface/tostring.xml b/reference/mongodb/bson/utcdatetimeinterface/tostring.xml index 1d63aa28c..3e3ce94f5 100644 --- a/reference/mongodb/bson/utcdatetimeinterface/tostring.xml +++ b/reference/mongodb/bson/utcdatetimeinterface/tostring.xml @@ -1,12 +1,10 @@ - - + - MongoDB\BSON\UTCDateTimeInterface::__toString - Devuelve la representación en forma de string de UTCDateTimeInterface + Devuelve la representación en string de esta UTCDateTimeInterface @@ -24,9 +22,9 @@ &reftitle.returnvalues; - - Devuelve la representación en forma de string de UTCDateTimeInterface. - + + Devuelve la representación en string de esta UTCDateTimeInterface. + diff --git a/reference/mongodb/functions/bson/fromjson.xml b/reference/mongodb/functions/bson/fromjson.xml index f2c9c2ec8..caebf814d 100644 --- a/reference/mongodb/functions/bson/fromjson.xml +++ b/reference/mongodb/functions/bson/fromjson.xml @@ -1,5 +1,5 @@ - + @@ -9,11 +9,11 @@ - - Esta función ha sido DEPRECADA desde la versión 1.20.0 de la extensión - y ha sido eliminada en la versión 2.0. Las aplicaciones deberían utilizar - MongoDB\BSON\Document::fromJSON en su lugar. - + + Esta función ha sido DEPRECADA a partir de la versión + 1.20.0 de la extensión y fue eliminada en la versión 2.0. Las aplicaciones + deben usar MongoDB\BSON\Document::fromJSON en su lugar. + @@ -23,11 +23,11 @@ stringMongoDB\BSON\fromJSON stringjson - - Convierte una cadena + + Convierte una cadena de JSON extendido - en su representación BSON. - + a su representación BSON. + @@ -36,9 +36,9 @@ json (string) - - Valor JSON a convertir. - + + Valor JSON que se desea convertir. + @@ -46,46 +46,43 @@ &reftitle.returnvalues; - - El documento serializado BSON como una cadena binaria. - + + El documento BSON serializado como una cadena binaria. + &reftitle.errors; - Lanza una excepción + Lanza MongoDB\Driver\Exception\UnexpectedValueException si - el valor JSON no puede ser convertido en BSON (por ejemplo, debido a - un error de sintaxis). + el valor JSON no puede convertirse a BSON (por ejemplo, debido a un error de sintaxis). - + &reftitle.changelog; - - - - - - &Version; - &Description; - - - - &mongodb.changelog.function-removed; - - - - + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + + &reftitle.examples; - Ejemplo con <function>MongoDB\BSON\fromJSON</function> + Ejemplo de <function>MongoDB\BSON\fromJSON</function> MongoDB\BSON\Document::fromJSON MongoDB\BSON\toJSON - MongoDB JSON extendido - MongoDB BSON + JSON Extendido de MongoDB + BSON de MongoDB diff --git a/reference/mongodb/functions/bson/fromphp.xml b/reference/mongodb/functions/bson/fromphp.xml index cd4b10b50..37b59b6f4 100644 --- a/reference/mongodb/functions/bson/fromphp.xml +++ b/reference/mongodb/functions/bson/fromphp.xml @@ -1,5 +1,5 @@ - + @@ -9,11 +9,11 @@ - - Esta función ha sido DEPRECADA desde la versión 1.20.0 de la extensión - y ha sido eliminada en la versión 2.0. Las aplicaciones deberían utilizar + + Esta función ha sido DEPRECADA a partir de la versión 1.20.0 + de la extensión y fue eliminada en la versión 2.0. Las aplicaciones deben usar MongoDB\BSON\Document::fromPHP en su lugar. - + @@ -21,24 +21,24 @@ &reftitle.description; stringMongoDB\BSON\fromPHP - arrayobjectvalue + arrayobjectvalor - - Serializa un array o objeto PHP (por ejemplo, documento) en su - representación BSON. - La cadena binaria devuelta describirá un documento BSON. - + + Serializa un array o objeto PHP (por ejemplo, un documento) a su + representación BSON. La + cadena binaria devuelta describirá un documento BSON. + &reftitle.parameters; - value (arrayobject) + valor (arrayobject) - - El valor PHP a serializar. - + + Valor PHP que se serializará. + @@ -46,9 +46,9 @@ &reftitle.returnvalues; - - El documento BSON serializado como cadena binaria. - + + El documento BSON serializado como una cadena binaria. + @@ -57,38 +57,36 @@ Lanza MongoDB\Driver\Exception\UnexpectedValueException si - el valor PHP no puede ser convertido en BSON. Las razones posibles incluyen, - pero no se limitan a, encontrar una instancia inesperada de - MongoDB\BSON\Type o - MongoDB\BSON\Serializable::bsonSerialize fallando al - devolver un &array; o una stdClass. + el valor PHP no puede convertirse a BSON. Las razones posibles incluyen, entre + otras, encontrar una instancia inesperada de + MongoDB\BSON\Type o que + MongoDB\BSON\Serializable::bsonSerialize no devuelva un + array o un stdClass. &reftitle.changelog; - - - - - - &Version; - &Description; - - - - &mongodb.changelog.function-removed; - - - - + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + + &reftitle.examples; - Ejemplo con <function>MongoDB\BSON\fromPHP</function> + Ejemplo de <function>MongoDB\BSON\fromPHP</function> - + MongoDB\BSON\toCanonicalExtendedJSON - Devuelve la representación JSON extendida canónica de un valor BSON + Devuelve la representación en Canonical Extended JSON de un valor BSON - - Esta función ha sido DEPRECADA desde la versión 1.20.0 de la extensión - y ha sido eliminada en la versión 2.0. Las aplicaciones deberían utilizar - MongoDB\BSON\Document::toCanonicalExtendedJSON en su lugar. - + + Esta función ha sido DEPRECADA a partir de la versión 1.20.0 de la extensión + y fue eliminada en la versión 2.0. Las aplicaciones deben usar en su lugar + MongoDB\BSON\Document::toCanonicalExtendedJSON. + @@ -23,14 +23,13 @@ stringMongoDB\BSON\toCanonicalExtendedJSON stringbson - - Convierte una cadena BSON en su - representación JSON extendida canónica. - El formato canónico privilegia la fidelidad de los tipos en detrimento de la - concisión de la salida y es el más adecuado para producir una salida que - puede ser convertida en BSON sin pérdida de información de tipo (por ejemplo, - los tipos numéricos permanecerán diferenciados). - + + Convierte una cadena BSON a su representación en + Canonical Extended JSON. + El formato canónico prioriza la fidelidad de tipos a costa de una salida menos concisa y es más adecuado + para producir salidas que puedan convertirse de vuelta a BSON sin pérdida de información de tipos + (por ejemplo, los tipos numéricos permanecerán diferenciados). + @@ -39,9 +38,9 @@ bson (string) - - El BSON a convertir. - + + Valor BSON que se convertirá. + @@ -49,9 +48,9 @@ &reftitle.returnvalues; - - El JSON convertido. - + + El valor JSON convertido. + @@ -63,21 +62,19 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - &mongodb.changelog.function-removed; - - - - + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + + @@ -156,7 +153,7 @@ foreach ($documents as $document) { MongoDB\BSON\Document::toCanonicalExtendedJSON MongoDB\BSON\fromJSON MongoDB\BSON\toRelaxedExtendedJSON - Especificación de JSON extendido + Especificación de JSON Extendido MongoDB BSON diff --git a/reference/mongodb/functions/bson/tojson.xml b/reference/mongodb/functions/bson/tojson.xml index c8f87ab5a..0f8efa42e 100644 --- a/reference/mongodb/functions/bson/tojson.xml +++ b/reference/mongodb/functions/bson/tojson.xml @@ -1,21 +1,21 @@ - + - MongoDB\BSON\toJSON - Devuelve la representación JSON extendida heredada de un valor BSON + Devuelve la representación en JSON Extendido Legado de un valor BSON - - Esta función ha sido DEPRECADA desde la versión 1.20.0 de la extensión - y ha sido eliminada en la versión 2.0. Las aplicaciones deberían utilizar + + Esta función ha sido DEPRECADA a partir de la versión + 1.20.0 de la extensión y fue eliminada en la versión 2.0. Las aplicaciones + deben usar en su lugar MongoDB\BSON\Document::toCanonicalExtendedJSON o - MongoDB\BSON\Document::toRelaxedExtendedJSON en su lugar. - + MongoDB\BSON\Document::toRelaxedExtendedJSON. + @@ -25,28 +25,33 @@ stringMongoDB\BSON\toJSON stringbson - - Convierte una cadena BSON en su representación JSON extendida heredada. - + + Convierte una cadena BSON a su representación en + JSON Extendido Legado. + Existen varios formatos JSON para representar BSON. Esta función implementa el "modo estricto" definido en - MongoDB Extended JSON, - que ha sido reemplazado por los formatos canónicos y extendidos definidos en la - especificación JSON extendida - e implementado por MongoDB\BSON\toCanonicalExtendedJSON + JSON Extendido de MongoDB, + que ha sido reemplazado por los formatos canónico y relajado definidos en + la + Especificación de JSON Extendido + e implementados por MongoDB\BSON\toCanonicalExtendedJSON y MongoDB\BSON\toRelaxedExtendedJSON, respectivamente. - JSON no soporta - NAN y - INF y el - formato JSON extendido de MongoDB no define otra representación para - estos valores (libbson producirá nan y inf literalmente, - que no pueden ser analizados como JSON válido). Si se trabaja con BSON que puede contener números no finitos, utilice por favor + JSON no admite + NAN ni + INF, y el + formato de JSON Extendido Legado de MongoDB no define una representación + alternativa para estos valores + (libbson generará + literales nan e inf, que pueden no + ser analizados como JSON válido). Si está trabajando con BSON que puede + contener números no finitos, utilice MongoDB\BSON\toCanonicalExtendedJSON o MongoDB\BSON\toRelaxedExtendedJSON. @@ -59,9 +64,9 @@ bson (string) - + Valor BSON a convertir. - + @@ -69,9 +74,9 @@ &reftitle.returnvalues; - + El valor JSON convertido. - + @@ -83,27 +88,25 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - &mongodb.changelog.function-removed; - - - - + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + + &reftitle.examples; - Ejemplo con <function>MongoDB\BSON\toJSON</function> + Ejemplo de <function>MongoDB\BSON\toJSON</function> MongoDB\BSON\fromJSON MongoDB\BSON\toCanonicalExtendedJSON MongoDB\BSON\toRelaxedExtendedJSON - MongoDB JSON Extendido - MongoDB BSON + JSON Extendido de MongoDB + BSON de MongoDB diff --git a/reference/mongodb/functions/bson/tophp.xml b/reference/mongodb/functions/bson/tophp.xml index e59ef6278..48706b5f1 100644 --- a/reference/mongodb/functions/bson/tophp.xml +++ b/reference/mongodb/functions/bson/tophp.xml @@ -1,19 +1,19 @@ - + MongoDB\BSON\toPHP - Devuelve la representación PHP de un valor BSON + Devuelve la representación en PHP de un valor BSON - - Esta función ha sido DEPRECADA desde la versión 1.20.0 de la extensión - y ha sido eliminada en la versión 2.0. Las aplicaciones deberían utilizar - MongoDB\BSON\Document::toPHP en su lugar. - + + Esta función ha sido DEPRECADA a partir de la versión + 1.20.0 de la extensión y fue eliminada en la versión 2.0. Las aplicaciones + deben usar MongoDB\BSON\Document::toPHP en su lugar. + @@ -24,11 +24,12 @@ stringbson arraytypeMaparray() - - Deserializa un documento BSON (es decir, una cadena binaria) en su representación PHP. - El parámetro typeMap puede ser utilizado para controlar los tipos PHP utilizados - para convertir los arrays y documentos BSON (tanto raíz como integrados). - + + Deserializa un documento BSON (es decir, una cadena binaria) a su + representación en PHP. El parámetro typeMap puede usarse + para controlar los tipos de PHP utilizados para convertir matrices y + documentos BSON (tanto raíz como incrustados). + &mongodb.warning.duplicate-keys; @@ -38,9 +39,9 @@ bson (string) - - El valor BSON a deserializar. - + + Valor BSON a deserializar. + &mongodb.parameter.typeMap; @@ -49,18 +50,18 @@ &reftitle.returnvalues; - - El valor PHP no serializado. - + + El valor en PHP deserializado. + &reftitle.errors; - Lanza una + Lanza MongoDB\Driver\Exception\InvalidArgumentException si - una clase en la tabla de tipos no puede ser instanciada o no implementa + una clase en el mapa de tipos no puede ser instanciada o no implementa MongoDB\BSON\Unserializable. &mongodb.throws.bson.unexpected; @@ -69,52 +70,51 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - &mongodb.changelog.function-removed; - - PECL mongodb 1.4.0 - - - Si la entrada contiene un tipo BSON no soportado o obsoleto, la extensión - ya no generará una advertencia en el registro de depuración, sino que creará - un objeto que represente dicho tipo. - - - - - PECL mongodb 1.3.2 - - - MongoDB\Driver\Exception\UnexpectedValueException - ya no lanza una excepción si la entrada contiene un tipo BSON no soportado - o obsoleto. Estos tipos serán ignorados (como lo eran en versiones anteriores a 1.3.0), aunque la extensión ahora escribirá una advertencia - en el registro de depuración (ver: mongodb.debug). - - - - - PECL mongodb 1.3.0 - - - MongoDB\Driver\Exception\UnexpectedValueException - es lanzada si la entrada contiene un tipo BSON no soportado o obsoleto. - Anteriormente, dichos tipos eran ignorados. - - - - - - - + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + PECL mongodb 1.4.0 + + + Si la entrada contiene un tipo BSON obsoleto no admitido, la extensión + ya no registrará una advertencia en el registro de depuración, sino que + creará un objeto que represente este tipo. + + + + + PECL mongodb 1.3.2 + + + Ya no se lanza MongoDB\Driver\Exception\UnexpectedValueException + si la entrada contiene un tipo BSON obsoleto no admitido. Tales tipos + serán ignorados (como lo eran en versiones anteriores a 1.3.0), + aunque la extensión registrará ahora una advertencia en el registro de + depuración (ver: mongodb.debug). + + + + + PECL mongodb 1.3.0 + + + Se lanza MongoDB\Driver\Exception\UnexpectedValueException + si la entrada contiene un tipo BSON obsoleto no admitido. Anteriormente, + tales tipos eran ignorados. + + + + + + diff --git a/reference/mongodb/functions/bson/torelaxedextendedjson.xml b/reference/mongodb/functions/bson/torelaxedextendedjson.xml index fdcb3f602..f1b5b8224 100644 --- a/reference/mongodb/functions/bson/torelaxedextendedjson.xml +++ b/reference/mongodb/functions/bson/torelaxedextendedjson.xml @@ -1,19 +1,20 @@ - + MongoDB\BSON\toRelaxedExtendedJSON - Devuelve la representación JSON extendida relajada de un valor BSON + Devuelve la representación en Relaxed Extended JSON de un valor BSON - - Esta función ha sido DEPRECADA desde la versión 1.20.0 de la extensión - y ha sido eliminada en la versión 2.0. Las aplicaciones deberían utilizar - MongoDB\BSON\Document::toRelaxedExtendedJSON en su lugar. - + + Esta función ha sido DEPRECADA a partir de la versión 1.20.0 de la extensión + y fue eliminada en la versión 2.0. Las aplicaciones deben usar + MongoDB\BSON\Document::toRelaxedExtendedJSON + en su lugar. + @@ -23,13 +24,11 @@ stringMongoDB\BSON\toRelaxedExtendedJSON stringbson - - Convierte una cadena BSON en su representación - JSON extendida relajada. - El formato relajado privilegia el uso de los tipos primitivos JSON - en detrimento de la fidelidad de los tipos y es el más adecuado para producir una salida que puede - ser fácilmente consumida por APIs web y humanos. - + + Convierte una cadena BSON a su representación en + Relaxed Extended JSON. + El formato relajado prefiere el uso de primitivas de tipo JSON a costa de la fidelidad de tipos y es más adecuado para producir salidas que puedan ser consumidas fácilmente por APIs web y humanos. + @@ -38,9 +37,9 @@ bson (string) - - La cadena BSON a convertir. - + + Valor BSON que se convertirá. + @@ -48,9 +47,9 @@ &reftitle.returnvalues; - + El valor JSON convertido. - + @@ -62,21 +61,19 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - &mongodb.changelog.function-removed; - - - - + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + + @@ -155,7 +152,7 @@ foreach ($documents as $document) { MongoDB\BSON\Document::toRelaxedExtendedJSON MongoDB\BSON\fromJSON MongoDB\BSON\toCanonicalExtendedJSON - JSON extendido + JSON Extendido MongoDB BSON diff --git a/reference/mongodb/functions/driver/monitoring/addsubscriber.xml b/reference/mongodb/functions/driver/monitoring/addsubscriber.xml index c19e1466f..1b101b355 100644 --- a/reference/mongodb/functions/driver/monitoring/addsubscriber.xml +++ b/reference/mongodb/functions/driver/monitoring/addsubscriber.xml @@ -1,11 +1,10 @@ - - + MongoDB\Driver\Monitoring\addSubscriber - Registra una suscripción de supervisión de eventos + Registra un suscriptor de eventos de monitorización de forma global @@ -14,16 +13,16 @@ voidMongoDB\Driver\Monitoring\addSubscriber MongoDB\Driver\Monitoring\Subscribersubscriber - - Registra una suscripción de supervisión de eventos global. - Los suscriptores serán notificados de todos los eventos en la extensión - para cualquier tipo de Manager. - + + Registra un suscriptor de eventos de monitorización de forma global. El suscriptor + será notificado de todos los eventos en la extensión para cualquier Manager. + - Si subscriber ya está registrado globalmente, esta - función no realiza ninguna operación. Si subscriber también - está registrado para uno o más Managers, será notificado solo una vez por evento para cada Manager. + Si el subscriber ya está registrado de forma global, esta + función no realiza ninguna acción. Si el subscriber también está + registrado con uno o más Managers, solo será notificado una vez de cada evento + para cada Manager. @@ -34,9 +33,9 @@ subscriber (MongoDB\Driver\Monitoring\Subscriber) - - Un objeto de suscripción de supervisión de eventos para registrar globalmente. - + + Un suscriptor de eventos de monitorización para registrar de forma global. + @@ -44,9 +43,9 @@ &reftitle.returnvalues; - + &return.void; - + diff --git a/reference/mongodb/functions/driver/monitoring/removesubscriber.xml b/reference/mongodb/functions/driver/monitoring/removesubscriber.xml index 1316125d4..0eba44696 100644 --- a/reference/mongodb/functions/driver/monitoring/removesubscriber.xml +++ b/reference/mongodb/functions/driver/monitoring/removesubscriber.xml @@ -1,11 +1,10 @@ - - + MongoDB\Driver\Monitoring\removeSubscriber - Elimina una suscripción de monitoreo de eventos global + Deregistra un suscriptor de eventos de supervisión globalmente @@ -14,13 +13,13 @@ voidMongoDB\Driver\Monitoring\removeSubscriber MongoDB\Driver\Monitoring\Subscribersubscriber - - Elimina una suscripción de monitoreo de eventos global. - + + Deregistra un suscriptor de eventos de supervisión globalmente. + - Si subscriber no está ya registrado, - esta función no realiza ninguna operación. + Si el subscriber no está registrado globalmente, + esta función no realiza ninguna acción. @@ -31,9 +30,9 @@ subscriber (MongoDB\Driver\Monitoring\Subscriber) - - Una suscripción de monitoreo de eventos a eliminar globalmente. - + + Un suscriptor de eventos de supervisión que se desregistrará globalmente. + @@ -41,9 +40,9 @@ &reftitle.returnvalues; - + &return.void; - + @@ -65,6 +64,7 @@ + + + La clase MongoDB\Driver\BulkWrite MongoDB\Driver\BulkWrite @@ -10,22 +11,22 @@
&reftitle.intro; - - El MongoDB\Driver\BulkWrite recopila una o más - operaciones de escritura que deberían ser enviadas al servidor. Después de agregar - un número cualquiera de operaciones de inserción, actualización y eliminación, - la colección puede ser ejecutada a través de + + La clase MongoDB\Driver\BulkWrite recopila una o más + operaciones de escritura que deben enviarse al servidor. Tras añadir cualquier + número de operaciones de inserción, actualización y eliminación, la colección + puede ejecutarse mediante MongoDB\Driver\Manager::executeBulkWrite. - - + + Las operaciones de escritura pueden ser ordenadas (por omisión) o no ordenadas. - Las operaciones de escritura ordenadas son enviadas al servidor, en el orden - proporcionado, para una ejecución serial. Si una escritura falla, todas las - operaciones restantes serán canceladas. Las operaciones no ordenadas son enviadas - al servidor en un orden arbitrario donde pueden ser ejecutadas en paralelo. - Todos los errores que ocurren son reportados después de que todas las - operaciones hayan sido intentadas. - + Las operaciones de escritura ordenadas se envían al servidor, en el orden + proporcionado, para su ejecución secuencial. Si una escritura falla, las + operaciones restantes se abortarán. Las operaciones no ordenadas se envían al + servidor en un orden arbitrario donde pueden ejecutarse en paralelo. Cualquier + error que ocurra se notificará después de que se hayan intentado todas las + operaciones. +
@@ -60,10 +61,12 @@ &reftitle.examples; - Operaciones de escritura ordenadas por tipo - - Las operaciones de escritura mixtas (es decir, las inserciones, las actualizaciones y las eliminaciones) serán ensambladas en comandos de escritura tipificados para ser enviados secuencialmente al servidor. - + Las operaciones de escritura mixtas se agrupan por tipo + + Las operaciones de escritura mixtas (es decir, inserciones, actualizaciones y + eliminaciones) se ensamblarán en comandos de escritura tipificados para + enviarse secuencialmente al servidor. + delete(['x' => 1]); ?> ]]> - - Resulta en cuatro comandos de escritura (es decir, idas y vueltas) - ejecutadas. Dado que las operaciones son ordenadas, la tercera inserción no puede ser enviada - hasta que la actualización previa sea ejecutada. - + + Dará como resultado la ejecución de cuatro comandos de escritura (es decir, + viajes de ida y vuelta). Dado que las operaciones están ordenadas, la tercera + inserción no puede enviarse hasta que se ejecute la actualización precedente. + - Operaciones de escritura ordenadas causando un error + Operaciones de escritura ordenadas que causan un error getWriteResult(); - // Verifica si la escritura no pudo ser satisfecha + // Comprobar si la preocupación de escritura no pudo cumplirse if ($writeConcernError = $result->getWriteConcernError()) { printf("%s (%d): %s\n", $writeConcernError->getMessage(), @@ -119,7 +122,7 @@ try { ); } - // Verifica si una operación de escritura no pudo ser completada + // Comprobar si alguna operación de escritura no se completó en absoluto foreach ($result->getWriteErrors() as $writeError) { printf("Operación#%d: %s (%d)\n", $writeError->getIndex(), @@ -133,7 +136,7 @@ try { } printf("Insertados %d documento(s)\n", $result->getInsertedCount()); -printf("Actualizados %d documento(s)\n", $result->getModifiedCount()); +printf("Actualizados %d documento(s)\n", $result->getModifiedCount()); ?> ]]> @@ -147,13 +150,13 @@ Insertados 4 documento(s) Actualizados 2 documento(s) ]]> - - Si el write concern no puede ser satisfecho, el ejemplo anterior mostrará - algo como: - + + Si la preocupación de escritura no pudiera cumplirse, el ejemplo anterior + mostraría algo como: + true, ) Operación#7: E11000 duplicate key error index: databaseName.collectionName.$_id_ dup key: { : 3 } (11000) @@ -161,9 +164,9 @@ Insertados 4 documento(s) Actualizados 2 documento(s) ]]> - - Si se ejecuta el ejemplo anterior, pero se permiten escrituras no ordenadas: - + + Si ejecutamos el ejemplo anterior, pero permitimos escrituras no ordenadas: + - + MongoDB\Driver\BulkWrite::__construct - Crear un nuevo BulkWrite + Crea un nuevo BulkWrite @@ -13,12 +13,12 @@ public MongoDB\Driver\BulkWrite::__construct arraynulloptions&null; - + Construye un nuevo MongoDB\Driver\BulkWrite, que es un objeto mutable al cual se pueden añadir una o más operaciones de escritura. Las - escrituras pueden ser ejecutadas posteriormente con + escritura(s) pueden entonces ser ejecutadas con MongoDB\Driver\Manager::executeBulkWrite. - + @@ -33,10 +33,10 @@ - Option - Type - Description - Defaut + Opción + Tipo + Descripción + Valor por omisión @@ -44,12 +44,14 @@ bypassDocumentValidation bool - - Si &true;, permite que las operaciones de inserción y actualización contorneen la validación a nivel de documento. - - - Esta opción está disponible en MongoDB 3.2+ y es ignorada para las versiones anteriores del servidor, que no soportan la validación a nivel de documento. - + + Si es &true;, permite que las operaciones de inserción y actualización + eviten la validación a nivel de documento. + + + Esta opción está disponible en MongoDB 3.2+ y es ignorada en versiones + anteriores del servidor, que no soportan validación a nivel de documento. + &false; @@ -57,12 +59,15 @@ comment mixed - - Un comentario arbitrario para ayudar a trazar la operación a través del perfil del servidor de base de datos, la salida currentOp y los registros. - - - Esta opción está disponible en MongoDB 4.4+ y lanzará una excepción en el momento de la ejecución si se especifica para una versión de servidor más antigua. - + + Un comentario arbitrario para ayudar a rastrear la operación a través + del perfilador de la base de datos, la salida currentOp y los registros. + + + Esta opción está disponible en MongoDB 4.4+ y generará una excepción + en tiempo de ejecución si se especifica para una versión anterior del + servidor. + &mongodb.option.let; @@ -70,9 +75,10 @@ ordered bool - Las operaciones ordenadas (&true;) son ejecutadas secuencialmente en el servidor MongoDB, - mientras que las operaciones no ordenadas (&false;) son enviadas al servidor - en un orden arbitrario y pueden ser ejecutadas en paralelo. + Las operaciones ordenadas (&true;) se ejecutan de forma serial en el + servidor de MongoDB, mientras que las operaciones no ordenadas + (&false;) son enviadas al servidor en un orden arbitrario y pueden + ser ejecutadas en paralelo. &true; @@ -94,32 +100,30 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 1.14.0 - - Adición de las opciones "comment" y "let". - - - - PECL mongodb 1.1.0 - - Adición de la opción "bypassDocumentValidation". - - - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 1.14.0 + + Se añadieron las opciones "comment" y "let". + + + + PECL mongodb 1.1.0 + + Se añadió la opción "bypassDocumentValidation". + + + + + @@ -154,7 +158,7 @@ try { } catch (MongoDB\Driver\Exception\BulkWriteException $e) { $result = $e->getWriteResult(); - // Verifica si la escritura no pudo ser realizada + // Comprobar si la preocupación de escritura no pudo ser cumplida if ($writeConcernError = $result->getWriteConcernError()) { printf("%s (%d): %s\n", $writeConcernError->getMessage(), @@ -163,9 +167,9 @@ try { ); } - // Verifica si algunas operaciones de escritura no fueron realizadas + // Comprobar si alguna operación de escritura no se completó en absoluto foreach ($result->getWriteErrors() as $writeError) { - printf("Operation#%d: %s (%d)\n", + printf("Operación#%d: %s (%d)\n", $writeError->getIndex(), $writeError->getMessage(), $writeError->getCode() @@ -176,10 +180,10 @@ try { exit; } -printf("Inserted %d document(s)\n", $result->getInsertedCount()); -printf("Updated %d document(s)\n", $result->getModifiedCount()); -printf("Upserted %d document(s)\n", $result->getUpsertedCount()); -printf("Deleted %d document(s)\n", $result->getDeletedCount()); +printf("Insertados %d documento(s)\n", $result->getInsertedCount()); +printf("Actualizados %d documento(s)\n", $result->getModifiedCount()); +printf("Incluidos %d documento(s)\n", $result->getUpsertedCount()); +printf("Eliminados %d documento(s)\n", $result->getDeletedCount()); ?> ]]> @@ -187,10 +191,10 @@ printf("Deleted %d document(s)\n", $result->getDeletedCount()); &example.outputs; diff --git a/reference/mongodb/mongodb/driver/bulkwrite/count.xml b/reference/mongodb/mongodb/driver/bulkwrite/count.xml index 132ee19eb..00ecf82e1 100644 --- a/reference/mongodb/mongodb/driver/bulkwrite/count.xml +++ b/reference/mongodb/mongodb/driver/bulkwrite/count.xml @@ -1,10 +1,10 @@ - + MongoDB\Driver\BulkWrite::count - Cuenta el número de operaciones de escritura en el lote + Cuenta el número de operaciones de escritura en la operación masiva @@ -13,10 +13,10 @@ public intMongoDB\Driver\BulkWrite::count - + Devuelve el número de operaciones de escritura añadidas al objeto - MongoDB\Driver\BulkWrite. - + MongoDB\Driver\BulkWrite. + @@ -27,10 +27,10 @@ &reftitle.returnvalues; - + Devuelve el número de operaciones de escritura añadidas al objeto MongoDB\Driver\BulkWrite. - + @@ -42,29 +42,27 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 1.2.0 - - Devuelve el número de operaciones de escritura añadidas al objeto - MongoDB\Driver\BulkWrite. Las versiones anteriores - devolvían el número de idas y vueltas cliente-servidor necesarias para ejecutar - todas las operaciones de escritura. - - - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 1.2.0 + + Devuelve el número de operaciones de escritura añadidas al objeto + MongoDB\Driver\BulkWrite. Las versiones anteriores + devolvían el número esperado de viajes de ida y vuelta del cliente al servidor + necesarios para ejecutar todas las operaciones de escritura. + + + + + @@ -114,6 +112,5 @@ sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si -vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> diff --git a/reference/mongodb/mongodb/driver/bulkwrite/delete.xml b/reference/mongodb/mongodb/driver/bulkwrite/delete.xml index 01f20fd16..c1a5fccbb 100644 --- a/reference/mongodb/mongodb/driver/bulkwrite/delete.xml +++ b/reference/mongodb/mongodb/driver/bulkwrite/delete.xml @@ -1,10 +1,10 @@ - + MongoDB\Driver\BulkWrite::delete - Añade una operación de eliminación al lote + Añade una operación de eliminación al lote masivo @@ -14,10 +14,10 @@ arrayobjectfilter arraynulldeleteOptions&null; - + Añade una operación de eliminación al MongoDB\Driver\BulkWrite. - + @@ -34,10 +34,10 @@ - Option - Type - Description - Defaut + Opción + Tipo + Descripción + Valor por omisión @@ -46,22 +46,21 @@ hint stringarrayobject - - Especificación de índice. Especifique el nombre del índice como string - o el patrón de clave de índice. Si se especifica, el sistema de consulta - solo considerará los planes que utilicen el índice sugerido. - - - Esta opción está disponible en MongoDB 4.4+ y lanzará una - excepción en el momento de la ejecución si se especifica para una versión de servidor - más antigua. - + + Especificación del índice. Especifique ya sea el nombre del índice como un string o + el patrón de clave del índice. Si se especifica, entonces el sistema de consultas solo + considerará planes que utilicen el índice indicado. + + + Esta opción está disponible en MongoDB 4.4+ y generará una + excepción en tiempo de ejecución si se especifica para una versión anterior del servidor. + limit bool - Elimina todos los documentos coincidentes (&false;), o solo el primer documento coincidente (&true;) + Eliminar todos los documentos coincidentes (&false;), o solo el primer documento coincidente (&true;) &false; @@ -75,9 +74,9 @@ &reftitle.returnvalues; - + &return.void; - + @@ -89,32 +88,30 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 1.8.0 - - Adición de la opción "hint". - - - - PECL mongodb 1.2.0 - - Adición de la opción "collation". - - - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 1.8.0 + + Se añadió la opción "hint". + + + + PECL mongodb 1.2.0 + + Se añadió la opción "collation". + + + + + diff --git a/reference/mongodb/mongodb/driver/bulkwrite/insert.xml b/reference/mongodb/mongodb/driver/bulkwrite/insert.xml index 80b0c1e4c..b302c8560 100644 --- a/reference/mongodb/mongodb/driver/bulkwrite/insert.xml +++ b/reference/mongodb/mongodb/driver/bulkwrite/insert.xml @@ -1,22 +1,22 @@ - + MongoDB\Driver\BulkWrite::insert - Añade una operación de inserción al lote + Añade una operación de inserción al lote masivo &reftitle.description; public mixedMongoDB\Driver\BulkWrite::insert - arrayobjectdocument + arrayobjectdocumento - - Añade una operación de inserción al + + Añade una operación de inserción a la MongoDB\Driver\BulkWrite. - + @@ -24,11 +24,11 @@ &reftitle.parameters; - document (arrayobject) + documento (arrayobject) - - El documento a insertar. - + + Un documento a insertar. + @@ -36,12 +36,11 @@ &reftitle.returnvalues; - + Devuelve el _id del documento insertado. Si el - document no tenía _id, el - MongoDB\BSON\ObjectId generado para la inserción será - devuelto. - + documento no tenía un _id, se devolverá el + MongoDB\BSON\ObjectId generado para la inserción. + @@ -53,28 +52,26 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 1.3.0 - - El _id del documento insertado es siempre devuelto. - Anteriormente, el método solo devolvía un valor si un - MongoDB\BSON\ObjectId era generado. - - - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 1.3.0 + + Siempre se devuelve el _id del documento insertado. + Anteriormente, el método solo devolvía un valor si se generaba un + MongoDB\BSON\ObjectId. + + + + + @@ -88,7 +85,7 @@ $bulk = new MongoDB\Driver\BulkWrite; $doc1 = ['x' => 1]; -$doc2 = ['_id' => 'custom-id', 'x' => 2]; +$doc2 = ['_id' => 'id-personalizado', 'x' => 2]; $doc3 = ['_id' => new MongoDB\BSON\ObjectId('0123456789abcdef01234567'), 'x' => 3]; $id1 = $bulk->insert($doc1); @@ -108,9 +105,9 @@ $result = $manager->executeBulkWrite('db.collection', $bulk); - string(24) "67f58058d1a0aa2fd80d55d0" + string(24) "67f58058d1a0aa2fd80d55d0" } -string(9) "custom-id" +string(18) "id-personalizado" object(MongoDB\BSON\ObjectId)#4 (1) { ["oid"]=> string(24) "0123456789abcdef01234567" diff --git a/reference/mongodb/mongodb/driver/bulkwrite/update.xml b/reference/mongodb/mongodb/driver/bulkwrite/update.xml index 161d5d61b..2566de1c2 100644 --- a/reference/mongodb/mongodb/driver/bulkwrite/update.xml +++ b/reference/mongodb/mongodb/driver/bulkwrite/update.xml @@ -1,5 +1,5 @@ - + @@ -15,10 +15,10 @@ arrayobjectnewObj arraynullupdateOptions&null; - + Añade una operación de actualización al MongoDB\Driver\BulkWrite. - + @@ -29,12 +29,12 @@ newObj (arrayobject) - - Un documento que contiene operadores de actualización (por ejemplo + + Un documento que contiene operadores de actualización (por ejemplo, $set), un documento de reemplazo (es decir, - solo expresiones field:value), o - una pipeline de agregación. - + únicamente expresiones campo:valor), o + una tubería de agregación. + @@ -46,10 +46,10 @@ - Option - Type - Description - Defaut + Opción + Tipo + Descripción + Valor por omisión @@ -57,17 +57,17 @@ arrayFilters array - + Un array de documentos de filtro que determina qué elementos de array - modificar para una operación de actualización en un campo de array. Véase - Especificar arrayFilters para las operaciones de actualización de array + modificar para una operación de actualización en un campo de array. Consulte + Especificar arrayFilters para operaciones de actualización de arrays en el manual de MongoDB para más información. - - - Esta opción está disponible en MongoDB 3.6+ y causará una - excepción en el momento de la ejecución si se especifica para una versión de servidor - más antigua. - + + + Esta opción está disponible en MongoDB 3.6+ y generará una + excepción en tiempo de ejecución si se especifica para una versión + anterior del servidor. + &mongodb.option.collation; @@ -75,23 +75,24 @@ hint stringarrayobject - - Especificación de índice. Especifique el nombre del índice como string - o el patrón de clave de índice. Si se especifica, el sistema de consultas - solo considerará los planes que usen el índice sugerido. - - - Esta opción está disponible en MongoDB 4.4+ y causará una - excepción en el momento de la ejecución si se especifica para una versión de servidor - más antigua. - + + Especificación de índice. Especifique ya sea el nombre del índice como + string o el patrón de clave de índice. Si se especifica, entonces el + sistema de consultas solo considerará planes que usen el índice + indicado. + + + Esta opción está disponible en MongoDB 4.2+ y generará una + excepción en tiempo de ejecución si se especifica para una versión + anterior del servidor. + multi bool - Actualiza solo el primer documento coincidente si &false;, o todos + Actualizar solo el primer documento coincidente si &false;, o todos los documentos coincidentes &true;. Esta opción no puede ser &true; si newObj es un documento de reemplazo. @@ -101,19 +102,19 @@ sort arrayobject - - Especifica qué documento la operación actualiza si la consulta coincide - con varios documentos. El primer documento coincidente por el orden de clasificación - será actualizado. - - - Esta opción no puede ser utilizada si "multi" es &true;. - - - Esta opción está disponible en MongoDB 4.4+ y causará una - excepción en el momento de la ejecución si se especifica para una versión de servidor - más antigua. - + + Especifica qué documento actualizará la operación si la consulta + coincide con múltiples documentos. Se actualizará el primer documento + coincidente según el orden de clasificación. + + + Esta opción no puede usarse si "multi" es &true;. + + + Esta opción está disponible en MongoDB 8.0+ y generará una + excepción en tiempo de ejecución si se especifica para una versión + anterior del servidor. + @@ -121,10 +122,10 @@ bool Si filter no coincide con un documento existente, - inserta un único documento. El documento será - creado a partir de newObj si es un documento de reemplazo - (es decir, sin operadores de actualización); de lo contrario, los operadores en - newObj serán aplicados a + inserta un único documento. El documento se + creará a partir de newObj si es un documento de + reemplazo (es decir, sin operadores de actualización); de lo contrario, + los operadores en newObj se aplicarán a filter para crear el nuevo documento. &false; @@ -140,9 +141,9 @@ &reftitle.returnvalues; - + &return.void; - + @@ -154,60 +155,59 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 1.21.0 - - Adición de la opción "sort". - - - - PECL mongodb 1.7.0 - - Adición de la opción "hint". - - - - PECL mongodb 1.6.0 - - El parámetro newObj acepta ahora una pipeline - de agregación. Esta funcionalidad requiere MongoDB 4.2+ y causará una - excepción en el momento de la ejecución si se especifica para una versión de servidor - más antigua. - - - - PECL mongodb 1.5.0 - - Utilizar la opción "arrayFilters" causará una excepción - en el momento de la ejecución si no es soportada por el servidor. Anteriormente, ninguna excepción era lanzada y la opción podía ser ignorada. - - - - PECL mongodb 1.4.0 - - Adición de la opción "arrayFilters". - - - - PECL mongodb 1.2.0 - - Adición de la opción "collation". - - - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 1.21.0 + + Se añadió la opción "sort". + + + + PECL mongodb 1.7.0 + + Se añadió la opción "hint". + + + + PECL mongodb 1.6.0 + + El parámetro newObj ahora acepta una tubería de + agregación. Esta característica requiere MongoDB 4.2+ y generará una + excepción en tiempo de ejecución si se especifica para una versión + anterior del servidor. + + + + PECL mongodb 1.5.0 + + Usar la opción "arrayFilters" generará una excepción + en tiempo de ejecución si el servidor no la soporta. Anteriormente, no + se generaba ninguna excepción y la opción podía ignorarse. + + + + PECL mongodb 1.4.0 + + Se añadió la opción "arrayFilters". + + + + PECL mongodb 1.2.0 + + Se añadió la opción "collation". + + + + + diff --git a/reference/mongodb/mongodb/driver/bulkwritecommand.xml b/reference/mongodb/mongodb/driver/bulkwritecommand.xml index b14020aeb..a71343b3e 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommand.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommand.xml @@ -1,7 +1,6 @@ - - - + + La clase MongoDB\Driver\BulkWriteCommand @@ -12,39 +11,38 @@
&reftitle.intro; - - MongoDB\Driver\BulkWriteCommand recupera una o varias - operaciones de escritura que deben ser enviadas al servidor mediante el comando - bulkWrite - introducido en MongoDB 8.0. Tras añadir cualquier número de operaciones de escritura, - operaciones de modificación y operaciones de eliminación, el comando puede ser ejecutado a través de + + La clase MongoDB\Driver\BulkWriteCommand recopila una o más + operaciones de escritura que deben enviarse al servidor usando el + comando bulkWrite + introducido en MongoDB 8.0. Tras añadir cualquier número de operaciones de inserción, + actualización y eliminación, el comando puede ejecutarse mediante MongoDB\Driver\Manager::executeBulkWriteCommand. - - - A diferencia de MongoDB\Driver\BulkWrite, donde todas las operaciones - de escritura deben apuntar a la misma colección, cada operación de escritura en - MongoDB\Driver\BulkWriteCommand debe apuntar a una + + + A diferencia de MongoDB\Driver\BulkWrite, donde todas las operaciones de escritura + deben dirigirse a la misma colección, cada operación de escritura dentro de + MongoDB\Driver\BulkWriteCommand puede dirigirse a una colección diferente. - - - Las operaciones de escritura pueden ser ordenadas (por defecto) o no ordenadas. Las operaciones - ordenadas son enviadas al servidor, en el orden proporcionado, para una ejecución - serial. Si una escritura falla, todas las operaciones restantes serán canceladas. - Las operaciones no ordenadas son enviadas al servidor en un orden arbitrario - donde pueden ser ejecutadas en paralelo. Todos los errores que ocurran - son reportados después de que todas las operaciones hayan sido intentadas. - + + + Las operaciones de escritura pueden ser ordenadas (por omisión) o no ordenadas. Las operaciones de escritura ordenadas se envían al servidor, en el orden proporcionado, para su + ejecución serial. Si una escritura falla, las operaciones restantes se abortarán. + Las operaciones no ordenadas se envían al servidor en un orden arbitrario + donde pueden ejecutarse en paralelo. Cualquier error que ocurra se reporta + después de que se hayan intentado todas las operaciones. +
&reftitle.classsynopsis; - + MongoDB\Driver\BulkWriteCommand - + final @@ -69,12 +67,11 @@ Operaciones de escritura mixtas - - Las operaciones de escritura mixtas (por ejemplo, inserciones, actualizaciones y eliminaciones) serán enviadas - al servidor mediante una sola - comando - bulkWrite. - + + Las operaciones de escritura mixtas (es decir, inserciones, actualizaciones y eliminaciones) se enviarán + al servidor usando un único + comando bulkWrite. + updateOne('db.coll_one', ['_id' => 1], ['$set' => ['x' => 1]]); $result = $manager->executeBulkWriteCommand($bulk); -printf("%d documento(s) han sido insertado(s)\n", $result->getInsertedCount()); -printf("%d documento(s) han sido actualizado(s)\n", $result->getModifiedCount()); +printf("Insertados %d documento(s)\n", $result->getInsertedCount()); +printf("Actualizados %d documento(s)\n", $result->getModifiedCount()); ?> ]]> @@ -106,8 +103,8 @@ printf("%d documento(s) han sido actualizado(s)\n", $result->getModifiedCount()) &example.outputs; @@ -135,7 +132,7 @@ try { var_dump($e->getWriteErrors()); } -printf("%d documento(s) han sido insertado(s)\n", $result->getInsertedCount()); +printf("Insertados %d documento(s)\n", $result->getInsertedCount()); ?> ]]> @@ -157,7 +154,7 @@ array(1) { } } } -2 documento(s) han sido insertado(s) +Insertados 2 documento(s) ]]> diff --git a/reference/mongodb/mongodb/driver/bulkwritecommand/construct.xml b/reference/mongodb/mongodb/driver/bulkwritecommand/construct.xml index 1dd888a33..498c1c6a8 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommand/construct.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommand/construct.xml @@ -1,11 +1,10 @@ - - - + + MongoDB\Driver\BulkWriteCommand::__construct - Crear una nueva BulkWriteCommand + Crea un nuevo BulkWriteCommand @@ -14,19 +13,19 @@ public MongoDB\Driver\BulkWriteCommand::__construct arraynulloptions&null; - - Construye una nueva MongoDB\Driver\BulkWriteCommand, - que puede ser utilizada para realizar múltiples operaciones de inserción, actualización y eliminación - en varias colecciones en una sola petición utilizando el comando - bulkWrite + + Construye un nuevo MongoDB\Driver\BulkWriteCommand, + que puede usarse para realizar muchas operaciones de inserción, actualización y + eliminación en múltiples colecciones en una sola petición usando el + comando bulkWrite introducido en MongoDB 8.0. Esto difiere de MongoDB\Driver\BulkWrite, que es compatible con todas las versiones del servidor pero limitado a una sola colección. - - - Después de que todas las operaciones de escritura hayan sido añadidas, este objeto puede ser ejecutado con - MongoDB\Driver\Manager::executeBulkWriteCommand. - + + + Después de añadir todas las operaciones de escritura, este objeto puede + ejecutarse con MongoDB\Driver\Manager::executeBulkWriteCommand. + @@ -44,7 +43,7 @@ Opción Tipo Descripción - Por omisión + Valor por omisión @@ -52,10 +51,10 @@ bypassDocumentValidation bool - - Si &true;, permite que las operaciones de inserción y actualización omitan - la validación a nivel de documento. - + + Si es &true;, permite que las operaciones de inserción y actualización + eviten la validación a nivel de documento. + &false; @@ -63,10 +62,11 @@ comment mixed - - Un comentario arbitrario para ayudar a rastrear la operación a través del - perfilador de la base de datos, la salida currentOp y los registros. - + + Un comentario arbitrario para ayudar a rastrear la operación a través + del perfilador de la base de datos, la salida de currentOp y los + registros. + &mongodb.option.let; @@ -74,12 +74,12 @@ ordered bool - - Si las operaciones en esta escritura masiva deben ser ejecutadas en el - orden en que fueron especificadas. Si &false;, las escrituras - continuarán siendo ejecutadas si una escritura individual falla. Si &true;, - las escrituras se detendrán si una escritura individual falla. - + + Si las operaciones en esta escritura masiva deben ejecutarse en el + orden en que fueron especificadas. Si es &false;, las escrituras + continuarán ejecutándose si una escritura individual falla. Si es + &true;, las escrituras se detendrán si una escritura individual falla. + &true; @@ -87,11 +87,11 @@ verboseResults bool - - Si los detalles de los resultados de cada operación exitosa deben ser - incluidos en el resultado en la - MongoDB\Driver\BulkWriteCommandResult retornada. - + + Si los resultados detallados de cada operación exitosa deben incluirse + en el MongoDB\Driver\BulkWriteCommandResult + devuelto. + &false; @@ -123,22 +123,22 @@ $manager = new MongoDB\Driver\Manager; $bulk = new MongoDB\Driver\BulkWriteCommand; -// Elimina los documentos de dos colecciones +// Eliminar documentos de ambas colecciones $bulk->deleteMany('db.coll_one', []); $bulk->deleteMany('db.coll_two', []); -// Añade los documentos a dos colecciones +// Insertar documentos en dos colecciones $bulk->insertOne('db.coll_one', ['_id' => 1]); $bulk->insertOne('db.coll_two', ['_id' => 2]); $bulk->insertOne('db.coll_two', ['_id' => 3]); -// Modifica un documento en "coll_one" +// Actualizar un documento en "coll_one" $bulk->updateOne('db.coll_one', ['_id' => 1], ['$set' => ['x' => 1]]); $result = $manager->executeBulkWriteCommand($bulk); -printf("%d documento(s) han sido insertado(s)\n", $result->getInsertedCount()); -printf("%d documento(s) han sido actualizado(s)\n", $result->getModifiedCount()); +printf("Insertados %d documento(s)\n", $result->getInsertedCount()); +printf("Actualizados %d documento(s)\n", $result->getModifiedCount()); ?> ]]> @@ -146,8 +146,8 @@ printf("%d documento(s) han sido actualizado(s)\n", $result->getModifiedCount()) &example.outputs; diff --git a/reference/mongodb/mongodb/driver/bulkwritecommand/count.xml b/reference/mongodb/mongodb/driver/bulkwritecommand/count.xml index 93bb51d7b..8c6895842 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommand/count.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommand/count.xml @@ -1,11 +1,10 @@ - - - + + MongoDB\Driver\BulkWriteCommand::count - Cuenta el número de operaciones de escritura en la BulkWriteCommand + Cuenta el número de operaciones de escritura en el BulkWriteCommand @@ -14,10 +13,11 @@ public intMongoDB\Driver\BulkWriteCommand::count - - Devuelve el número de operaciones de escritura añadidas al - objeto MongoDB\Driver\BulkWriteCommand. - + + Devuelve el número de operaciones de escritura añadidas al objeto + MongoDB\Driver\BulkWriteCommand. + + @@ -27,10 +27,10 @@ &reftitle.returnvalues; - - Devuelve el número de operaciones de escritura añadidas al - objeto MongoDB\Driver\BulkWriteCommand. - + + Devuelve el número de operaciones de escritura añadidas al objeto + MongoDB\Driver\BulkWriteCommand. + diff --git a/reference/mongodb/mongodb/driver/bulkwritecommand/deletemany.xml b/reference/mongodb/mongodb/driver/bulkwritecommand/deletemany.xml index 2f8d831f1..8d9ffd7d5 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommand/deletemany.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommand/deletemany.xml @@ -1,7 +1,6 @@ - - - + + MongoDB\Driver\BulkWriteCommand::deleteMany @@ -16,12 +15,12 @@ arrayobjectfilter arraynulloptions&null; - + Añade una operación deleteMany a la MongoDB\Driver\BulkWriteCommand. Todos los documentos que coincidan con filter en la colección identificada por namespace serán eliminados. - + @@ -41,7 +40,7 @@ Opción Tipo Descripción - Por omisión + Valor por omisión @@ -50,11 +49,11 @@ hint stringarrayobject - - Especificación del índice. Especifique el nombre del índice como string - o el modelo de clave del índice. Si se especifica, el sistema de consulta solo - considerará los planes que utilicen el índice sugerido. - + + Especificación de índice. Especifique ya sea el nombre del índice como + string o el patrón de clave de índice. Si se especifica, entonces el + sistema de consultas solo considerará planes que usen el índice indicado. + @@ -68,9 +67,9 @@ &reftitle.returnvalues; - + &return.void; - + diff --git a/reference/mongodb/mongodb/driver/bulkwritecommand/deleteone.xml b/reference/mongodb/mongodb/driver/bulkwritecommand/deleteone.xml index 5ce3b1185..66fb88928 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommand/deleteone.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommand/deleteone.xml @@ -1,7 +1,6 @@ - - - + + MongoDB\Driver\BulkWriteCommand::deleteOne @@ -16,12 +15,12 @@ arrayobjectfilter arraynulloptions&null; - + Añade una operación deleteOne a la MongoDB\Driver\BulkWriteCommand. El primer documento que coincida con filter en la colección identificada por namespace será eliminado. - + @@ -41,7 +40,7 @@ Opción Tipo Descripción - Por omisión + Valor por omisión @@ -50,11 +49,12 @@ hint stringarrayobject - - Especificación del índice. Especifique el nombre del índice como string - o el modelo de clave del índice. Si se especifica, el sistema de consulta solo - considerará los planes que utilicen el índice sugerido. - + + Especificación de índice. Especifique ya sea el nombre del índice como + string o el patrón de clave del índice. Si se especifica, entonces el + sistema de consultas solo considerará planes que usen el índice + indicado. + @@ -68,9 +68,9 @@ &reftitle.returnvalues; - + &return.void; - + diff --git a/reference/mongodb/mongodb/driver/bulkwritecommand/insertone.xml b/reference/mongodb/mongodb/driver/bulkwritecommand/insertone.xml index 5c9e1f1f5..6d907200f 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommand/insertone.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommand/insertone.xml @@ -1,7 +1,6 @@ - - - + + MongoDB\Driver\BulkWriteCommand::insertOne @@ -15,12 +14,12 @@ stringnamespace arrayobjectdocument - - Añade una operación insertOne a la - MongoDB\Driver\BulkWriteCommand. El documento será - insertado en la colección identificada por + + Añade una operación insertOne al + MongoDB\Driver\BulkWriteCommand. El documento se + insertará en la colección identificada por namespace. - + @@ -30,9 +29,9 @@ document (arrayobject) - - El documento a insertar. - + + Un documento a insertar. + @@ -40,12 +39,12 @@ &reftitle.returnvalues; - + Devuelve el _id del documento insertado. Si el - document no tenía un _id, el - MongoDB\BSON\ObjectId generado para la inserción será - devuelto. - + document no tenía un _id, se + devolverá el MongoDB\BSON\ObjectId generado para la + inserción. + diff --git a/reference/mongodb/mongodb/driver/bulkwritecommand/replaceone.xml b/reference/mongodb/mongodb/driver/bulkwritecommand/replaceone.xml index 4571354b6..c9d64a361 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommand/replaceone.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommand/replaceone.xml @@ -1,7 +1,6 @@ - - - + + MongoDB\Driver\BulkWriteCommand::replaceOne @@ -17,12 +16,13 @@ arrayobjectreplacement arraynulloptions&null; - - Añade una operación replaceOne a la - MongoDB\Driver\BulkWriteCommand. El primer documento que - coincida con filter en la colección identificada por + + Añade una operación replaceOne al + MongoDB\Driver\BulkWriteCommand. El primer documento + que coincida con filter en la colección identificada por namespace será reemplazado. - + + @@ -33,9 +33,9 @@ replacement (arrayobject) - + Un documento de reemplazo. - + @@ -59,31 +59,32 @@ hint stringarrayobject - - Especificación del índice. Especifique el nombre del índice como string - o el modelo de clave del índice. Si se especifica, el sistema de consulta no - considerará planes que no utilicen el índice sugerido. - + + Especificación de índice. Especifique ya sea el nombre del índice como + string o el patrón de clave del índice. Si se especifica, entonces el + sistema de consultas solo considerará planes que usen el índice + indicado. + sort arrayobject - - Especifica qué documento reemplazará la operación si la consulta coincide con - múltiples documentos. El primer documento que coincida con el orden de clasificación - será reemplazado. - + + Especifique qué documento reemplaza la operación si la consulta + coincide con múltiples documentos. El primer documento coincidente + según el orden de clasificación será reemplazado. + upsert bool - Si filter no coincide con ningún documento, - inserta un documento single. El documento será - creado desde replacement. + Si filter no coincide con un documento existente, + inserta un único documento. El documento será + creado a partir de replacement. &false; @@ -98,9 +99,9 @@ &reftitle.returnvalues; - + &return.void; - + diff --git a/reference/mongodb/mongodb/driver/bulkwritecommand/updatemany.xml b/reference/mongodb/mongodb/driver/bulkwritecommand/updatemany.xml index 68492ad41..62c57fa22 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommand/updatemany.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommand/updatemany.xml @@ -1,7 +1,6 @@ - - - + + MongoDB\Driver\BulkWriteCommand::updateMany @@ -17,12 +16,13 @@ arrayobjectupdate arraynulloptions&null; - + Añade una operación updateMany a la MongoDB\Driver\BulkWriteCommand. Todos los documentos que coincidan con filter en la colección identificada por namespace serán actualizados. - + + @@ -33,11 +33,11 @@ update (arrayobject) - - Un documento que contiene operadores de actualización (por ejemplo - $set) o una + + Un documento que contiene ya sea operadores de actualización (por ejemplo + $set) o un pipeline de agregación. - + @@ -52,7 +52,7 @@ Opción Tipo Descripción - Por omisión + Valor por omisión @@ -60,12 +60,13 @@ arrayFilters array - + Un array de documentos de filtro que determina qué elementos de array - modificar para una operación de actualización en un campo de array. Consulte - Especificar arrayFilters para operaciones de actualización de array - en el manual de MongoDB para obtener más información. - + modificar para una operación de actualización en un campo de array. + Consulte + Especificar arrayFilters para operaciones de actualización de arrays + en el manual de MongoDB para más información. + &mongodb.option.collation; @@ -73,21 +74,22 @@ hint stringarrayobject - - Especificación del índice. Especifique el nombre del índice como string o - mediante el patrón de clave del índice. Si se especifica, el sistema de consulta solo - considerará los planes que utilicen el índice sugerido. - + + Especificación de índice. Especifique ya sea el nombre del índice como + string o el patrón de clave de índice. Si se especifica, entonces el + sistema de consultas solo considerará planes que usen el índice + indicado. + upsert bool - Si filter no coincide con ningún documento existente, - insertar un documento single. El documento será creado - aplicando los operadores en update a todos - los valores de campo en filter. + Si filter no coincide con un documento existente, + inserta un único documento. El documento se + creará aplicando los operadores en update a + cualquier valor de campo en filter. &false; @@ -102,9 +104,9 @@ &reftitle.returnvalues; - + &return.void; - + @@ -144,6 +146,7 @@ $result = $manager->executeBulkWriteCommand($bulk); MongoDB\Driver\BulkWriteCommandResult + - - + + MongoDB\Driver\BulkWriteCommand::updateOne - Añade una operación updateOne + Añadir una operación updateOne @@ -17,12 +16,13 @@ arrayobjectupdate arraynulloptions&null; - - Añade una operación updateOne a la - MongoDB\Driver\BulkWriteCommand. El primer documento que - coincida con filter en la colección identificada por + + Añade una operación updateOne al + MongoDB\Driver\BulkWriteCommand. El primer documento + que coincida con filter en la colección identificada por namespace será actualizado. - + + @@ -33,11 +33,11 @@ update (arrayobject) - - Un documento que contiene operadores de actualización (por ejemplo - $set) o una + + Un documento que contiene ya sea operadores de actualización (por ejemplo + $set) o un pipeline de agregación. - + @@ -60,12 +60,13 @@ arrayFilters array - + Un array de documentos de filtro que determina qué elementos de array - deben ser modificados para una operación de actualización en un campo de array. Ver - Especificar arrayFilters para operaciones de actualización de array - en la documentación de MongoDB para más información. - + modificar para una operación de actualización en un campo de array. + Consulte + Especificar arrayFilters para operaciones de actualización de arrays + en el manual de MongoDB para más información. + &mongodb.option.collation; @@ -73,32 +74,33 @@ hint stringarrayobject - - Especificación del índice. Especifique el nombre del índice como string - o el patrón de clave del índice. Si se especifica, el sistema de consulta no - considerará planes que no utilicen el índice sugerido. - + + Especificación de índice. Especifique ya sea el nombre del índice como + string o el patrón de clave de índice. Si se especifica, entonces el + sistema de consultas solo considerará planes que usen el índice + indicado. + sort arrayobject - - Especifica qué documento será reemplazado por la operación si la consulta coincide - con múltiples documentos. El primer documento que coincida con el orden de clasificación - será reemplazado. - + + Especifica qué documento actualizará la operación si la consulta + coincide con múltiples documentos. El primer documento coincidente + según el orden de ordenación será actualizado. + upsert bool - Si filter no coincide con ningún documento existente, - insertar un documento single. El documento será creado - aplicando los operadores en update a todos - los valores de campo en filter. + Si filter no coincide con un documento existente, + inserta un único documento. El documento será + creado aplicando operadores en update a cualquier + valor de campo en filter. &false; @@ -113,9 +115,9 @@ &reftitle.returnvalues; - + &return.void; - + diff --git a/reference/mongodb/mongodb/driver/bulkwritecommandresult.xml b/reference/mongodb/mongodb/driver/bulkwritecommandresult.xml index 95c491315..4468d60ba 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommandresult.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommandresult.xml @@ -1,7 +1,6 @@ - - - + + La clase MongoDB\Driver\BulkWriteCommandResult @@ -12,23 +11,24 @@
&reftitle.intro; - - La clase MongoDB\Driver\BulkWriteCommandResult encapsula - la información sobre una - MongoDB\Driver\BulkWriteCommand ejecutada y devuelta por + + La clase MongoDB\Driver\BulkWriteCommandResult + encapsula información sobre un + MongoDB\Driver\BulkWriteCommand ejecutado y es + devuelta por MongoDB\Driver\Manager::executeBulkWriteCommand. - +
&reftitle.classsynopsis; - + MongoDB\Driver\BulkWriteCommandResult - + final diff --git a/reference/mongodb/mongodb/driver/bulkwritecommandresult/getdeletedcount.xml b/reference/mongodb/mongodb/driver/bulkwritecommandresult/getdeletedcount.xml index dfdf35def..6993a9d12 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommandresult/getdeletedcount.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommandresult/getdeletedcount.xml @@ -1,7 +1,6 @@ - - - + + MongoDB\Driver\BulkWriteCommandResult::getDeletedCount @@ -14,8 +13,8 @@ final public intMongoDB\Driver\BulkWriteCommandResult::getDeletedCount - - + + @@ -25,9 +24,9 @@ &reftitle.returnvalues; - + Devuelve el número total de documentos eliminados por todas las operaciones. - + diff --git a/reference/mongodb/mongodb/driver/bulkwritecommandresult/getdeleteresults.xml b/reference/mongodb/mongodb/driver/bulkwritecommandresult/getdeleteresults.xml index 0ed9e74fb..7cfb3f18d 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommandresult/getdeleteresults.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommandresult/getdeleteresults.xml @@ -1,11 +1,10 @@ - - - + + MongoDB\Driver\BulkWriteCommandResult::getDeleteResults - Devuelve los resultados detallados de las eliminaciones exitosas + Devuelve resultados detallados para eliminaciones exitosas @@ -14,8 +13,8 @@ final public MongoDB\BSON\DocumentnullMongoDB\Driver\BulkWriteCommandResult::getDeleteResults - - + + @@ -25,12 +24,12 @@ &reftitle.returnvalues; - - Devuelve un documento que contiene los resultados de cada operación de - eliminación exitosa, o &null; si los resultados detallados no fueron solicitados. Las + + Devuelve un documento que contiene el resultado de cada operación de + eliminación exitosa, o &null; si no se solicitaron resultados detallados. Las claves del documento corresponderán al índice de la operación de escritura - de MongoDB\Driver\BulkWriteCommand. - + desde MongoDB\Driver\BulkWriteCommand. + diff --git a/reference/mongodb/mongodb/driver/bulkwritecommandresult/getinsertedcount.xml b/reference/mongodb/mongodb/driver/bulkwritecommandresult/getinsertedcount.xml index 9a45697de..47e71f0e7 100644 --- a/reference/mongodb/mongodb/driver/bulkwritecommandresult/getinsertedcount.xml +++ b/reference/mongodb/mongodb/driver/bulkwritecommandresult/getinsertedcount.xml @@ -1,7 +1,6 @@ - - - + + MongoDB\Driver\BulkWriteCommandResult::getInsertedCount @@ -14,8 +13,8 @@ final public intMongoDB\Driver\BulkWriteCommandResult::getInsertedCount - - + + @@ -25,10 +24,10 @@ &reftitle.returnvalues; - - Devuelve el número total de documentos insertados (excluyendo los upserts) por todas - las operaciones. - + + Devuelve el número total de documentos insertados (excluyendo los upserts) por + todas las operaciones. + diff --git a/reference/mongodb/mongodb/driver/clientencryption.xml b/reference/mongodb/mongodb/driver/clientencryption.xml index 993177523..bbdaf026b 100644 --- a/reference/mongodb/mongodb/driver/clientencryption.xml +++ b/reference/mongodb/mongodb/driver/clientencryption.xml @@ -1,7 +1,8 @@ - + + La clase MongoDB\Driver\ClientEncryption MongoDB\Driver\ClientEncryption @@ -10,22 +11,22 @@
&reftitle.intro; - - La clase MongoDB\Driver\ClientEncryption gestiona la - creación de claves de datos para el cifrado del lado del cliente, así como el - cifrado y descifrado manual de los valores. - + + La clase MongoDB\Driver\ClientEncryption gestiona + la creación de claves de datos para la cifrado lado-cliente, así como el + cifrado y descifrado manual de valores. +
&reftitle.classsynopsis; - + MongoDB\Driver\ClientEncryption - + final @@ -34,7 +35,7 @@ - + &Constants; const @@ -86,7 +87,7 @@
- +
&reftitle.constants; @@ -94,48 +95,49 @@ MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC - Especifica un algoritmo para el cifrado determinista, que es adecuado para las consultas. + Especifica un algoritmo para el cifrado determinista, que es adecuado para consultas. MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM - Especifica un algoritmo para el cifrado aleatorio. + Especifica un algoritmo para el cifrado aleatorio MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED - Especifica un algoritmo para una carga útil indexada y cifrada, que puede ser utilizada con el cifrado de consultas. - Para insertar o consultar con una carga útil indexada y cifrada, el MongoDB\Driver\Manager debe ser configurado con la opción de controlador "autoEncryption". La opción de cifrado automático "bypassQueryAnalysis" puede ser &true;. La opción de cifrado automático "bypassAutoEncryption" debe ser &false;. + Especifica un algoritmo para un contenido cifrado indexado, que puede usarse con cifrado consultable. + Para insertar o consultar con un contenido cifrado indexado, el MongoDB\Driver\Manager debe configurarse con la opción de controlador "autoEncryption". La opción de auto-cifrado "bypassQueryAnalysis" puede ser &true;. La opción de auto-cifrado "bypassAutoEncryption" debe ser &false;. MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED - Especifica un algoritmo para una carga útil no indexada y cifrada. + Especifica un algoritmo para un contenido cifrado no indexado. MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE - - Especifica un algoritmo para una carga útil cifrada por rango, que puede ser utilizada - con el cifrado de consultas. - - - Para consultar con una carga útil cifrada por rango, el - MongoDB\Driver\Manager debe ser configurado con la opción de controlador - "autoEncryption". La opción de cifrado automático - "bypassQueryAnalysis" puede ser &true;. La opción de cifrado automático - "bypassAutoEncryption" debe ser &false;. - + + Especifica un algoritmo para un contenido cifrado de rango, que puede usarse + con cifrado consultable. + + + Para consultar con un contenido cifrado de rango, el + MongoDB\Driver\Manager debe configurarse con la + opción de controlador "autoEncryption". La opción de + auto-cifrado "bypassQueryAnalysis" puede ser &true;. + La opción de auto-cifrado "bypassAutoEncryption" debe + ser &false;. + - La extensión aún no soporta las consultas de rango para los tipos de campo BSON Decimal128. + La extensión aún no admite consultas de rango para tipos de campo BSON Decimal128. @@ -143,20 +145,20 @@ MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY - - Especifica un tipo de consulta de igualdad, que es utilizado en conjunción con + + Especifica un tipo de consulta de igualdad, que se usa en conjunto con MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED. - + MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE - - Especifica un tipo de consulta de rango, que es utilizado en conjunción con + + Especifica un tipo de consulta de rango, que se usa en conjunto con MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE. - + @@ -166,60 +168,55 @@
&reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 2.0.0 - - - Eliminar MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED - y - - Eliminado MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW - y MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW. - - - - - PECL mongodb 1.20.0 - - - Añadido MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE - y MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE. - - - Deprecado MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW - y MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW. - - - - - PECL mongodb 1.16.0 - - Añadido MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW + + + + + &Version; + &Description; + + + + + PECL mongodb 2.0.0 + + + Se eliminó MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW + y MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW. + + + + + PECL mongodb 1.20.0 + + + Se añadió MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE + y MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE. + + + Se declaró obsoleto MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW y MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW. - - - - PECL mongodb 1.14.0 - - Añadido MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED, - MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED, - y MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY. - - - - - - + + + + + PECL mongodb 1.16.0 + + Se añadió MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW + y MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW. + + + + PECL mongodb 1.14.0 + + Se añadió MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED, + MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED, + y MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY. + + + + +
@@ -235,23 +232,23 @@ - + diff --git a/reference/mongodb/mongodb/driver/command.xml b/reference/mongodb/mongodb/driver/command.xml index aecd34ea5..54eaa1ea4 100644 --- a/reference/mongodb/mongodb/driver/command.xml +++ b/reference/mongodb/mongodb/driver/command.xml @@ -1,7 +1,8 @@ - + + La clase MongoDB\Driver\Command MongoDB\Driver\Command @@ -10,24 +11,25 @@
&reftitle.intro; - - La clase MongoDB\Driver\Command es un objeto de valor + + La clase MongoDB\Driver\Command es un objeto valor que representa un comando de base de datos. - - - Para proporcionar Command Helpers, el objeto MongoDB\Driver\Command debe ser compuesto. - + + + Para proporcionar asistentes de comandos el objeto + MongoDB\Driver\Command debe estar compuesto. +
&reftitle.classsynopsis; - + MongoDB\Driver\Command - + final @@ -47,7 +49,7 @@ &reftitle.examples; - Compuesto <classname>MongoDB\Driver\Command</classname> para proporcionar un asistente para crear colecciones + Composición de <classname>MongoDB\Driver\Command</classname> para proporcionar un asistente para crear colecciones - + - La clase MongoDB\Driver\Cursor @@ -12,13 +11,12 @@
&reftitle.intro; - - La clase MongoDB\Driver\Cursor - encapsula el resultado de un comando o de una consulta MongoDB, - que puede ser devuelto por, respectivamente, + + La clase MongoDB\Driver\Cursor encapsula + los resultados de un comando o consulta de MongoDB y puede ser devuelta por MongoDB\Driver\Manager::executeCommand o - MongoDB\Driver\Manager::executeQuery. - + MongoDB\Driver\Manager::executeQuery, respectivamente. +
@@ -51,33 +49,31 @@
&reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 1.9.0 - - Implementa Iterator. - - - - PECL mongodb 1.6.0 - - Implementación de MongoDB\Driver\CursorInterface, - que extiende Traversable. - - - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 1.9.0 + + Implementa Iterator. + + + + PECL mongodb 1.6.0 + + Implementa MongoDB\Driver\CursorInterface, + que extiende Traversable. + + + + +
@@ -85,39 +81,39 @@ Lectura de un conjunto de resultados - + MongoDB\Driver\Manager::executeCommand y - MongoDB\Driver\Manager::executeQuery ambos - devuelven su(s) resultado(s) como un objeto MongoDB\Driver\Cursor. - Este objeto puede ser utilizado para iterar dentro del conjunto de resultados de la - comando o de la consulta. - - - Debido a que MongoDB\Driver\Cursor implementa la interfaz - Traversable, se puede simplemente iterar - sobre el conjunto de resultados con + MongoDB\Driver\Manager::executeQuery devuelven + sus resultados como un objeto MongoDB\Driver\Cursor. + Este objeto puede usarse para iterar sobre el conjunto de resultados del + comando o consulta. + + + Dado que MongoDB\Driver\Cursor implementa la + interfaz Traversable, puede simplemente + iterar sobre el conjunto de resultados con foreach. - + insert(['name' => 'Ceres', 'size' => 946, 'distance' => 2.766]); $bulkWrite->insert(['name' => 'Vesta', 'size' => 525, 'distance' => 2.362]); $manager->executeBulkWrite("test.asteroids", $bulkWrite); -/* Consulta para todos los elementos de la colección */ +/* Consultar todos los elementos de la colección */ $query = new MongoDB\Driver\Query( [] ); -/* Interroga la colección "asteroids" de la base de datos "test" */ +/* Consultar la colección "asteroids" de la base de datos "test" */ $cursor = $manager->executeQuery("test.asteroids", $query); -/* $cursor contiene ahora un objeto que envuelve el conjunto de resultados. - * Utilice foreach() para iterar sobre todos los resultados */ +/* $cursor ahora contiene un objeto que envuelve el conjunto de resultados. Usar + * foreach() para iterar sobre todos los resultados */ foreach($cursor as $document) { print_r($document); } @@ -155,39 +151,40 @@ stdClass Object - Lectura de un conjunto de resultados para un cursor en cola - - Los cursores en cola - son un tipo especial de cursor MongoDB que permite al cliente leer - algunos resultados y esperar hasta que más documentos - se vuelvan disponibles. Estos cursores se utilizan principalmente con - Capped Collections - y Change Streams. - - - Aunque los cursores normales pueden ser recorridos una vez con - foreach, este enfoque no funcionará con los - cursores en cola. Cuando foreach se utiliza con un - cursor en cola, el bucle se detendrá al final del conjunto de resultados inicial. - Intentar continuar la iteración sobre el cursor con un segundo + Lectura de un conjunto de resultados para un cursor rastreable + + Los cursores rastreables + son un tipo especial de cursor de MongoDB que permite al cliente leer algunos + resultados y luego esperar hasta que haya más documentos disponibles. Estos + cursores se usan principalmente con + colecciones limitadas + y flujos de cambios. + + + Mientras que los cursores normales pueden iterarse una vez con + foreach, ese enfoque no funcionará con cursores rastreables. + Cuando se usa foreach con un cursor rastreable, el bucle + terminará al llegar al final del conjunto de resultados inicial. Intentar + continuar la iteración en el cursor con un segundo foreach lanzaría una excepción, ya que PHP intenta - rebobinar el cursor. Al igual que los objetos result en otros controladores - de base de datos, los cursores en MongoDB solo admiten la iteración hacia adelante, lo que significa que no pueden ser rebobinados. - - - Para leer continuamente desde un cursor en cola, el objeto Cursor debe ser - envuelto con un IteratorIterator. Esto permite - a la aplicación controlar directamente la iteración del cursor, evitar - rebobinar accidentalmente el cursor y decidir cuándo esperar nuevos resultados o detener completamente la iteración. - - - Para demostrar un cursor en acción, se utilizarán dos scripts: un - "Productor" y un "Consumidor". El script Productor creará una nueva colección plafonada utilizando el - comando - Create y - procederá a insertar un nuevo documento en esta colección - cada segundo. - + retroceder el cursor. Al igual que los objetos de resultado en otros controladores + de bases de datos, los cursores en MongoDB solo admiten la iteración hacia + adelante, lo que significa que no pueden retrocederse. + + + Para leer de forma continua desde un cursor rastreable, el objeto Cursor + debe envolverse con un IteratorIterator. Esto permite + que la aplicación controle directamente la iteración del cursor, evite + retroceder el cursor sin querer y decida cuándo esperar nuevos resultados + o detener completamente la iteración. + + + Para demostrar un cursor rastreable en acción, se usarán dos scripts: un + "productor" y un "consumidor". El script productor creará una nueva colección + limitada usando el comando + create e insertará + un nuevo documento en esa colección cada segundo. + ]]> - - Con el script Productor aún en ejecución, un segundo script consumidor puede ser ejecutado para leer los documentos insertados utilizando un cursor en cola, indicado por las opciones tailable y awaitData a - MongoDB\Driver\Query::__construct. - + + Con el script productor aún en ejecución, puede ejecutarse un segundo script + consumidor para leer los documentos insertados usando un cursor rastreable, + indicado por las opciones tailable y + awaitData en MongoDB\Driver\Query::__construct. + rewind(); while (true) { if ($iterator->valid()) { $document = $iterator->current(); - printf("Consumed document created at: %s\n", $document->createdAt); + printf("Documento consumido creado en: %s\n", $document->createdAt); } $iterator->next(); @@ -244,22 +243,27 @@ while (true) { ?> ]]> - - El script consumidor comenzará imprimiendo rápidamente todos los - documentos disponibles en la colección plafonada (como si - foreach hubiera sido utilizado); sin embargo, no se - detendrá al final del conjunto de resultados inicial. Dado que - el cursor está en cola, la llamada a - IteratorIterator::next se bloquea y espera resultados adicionales. IteratorIterator::valid también se utiliza para verificar si realmente hay datos disponibles para leer en cada paso. - + + El script consumidor comenzará imprimiendo rápidamente todos los documentos + disponibles en la colección limitada (como si se hubiera usado + foreach); sin embargo, no terminará al llegar al final + del conjunto de resultados inicial. Dado que el cursor es rastreable, llamar + a IteratorIterator::next bloqueará y esperará + resultados adicionales. IteratorIterator::valid también + se usa para verificar si hay realmente datos disponibles para leer en cada + paso. + - Este ejemplo utiliza la opción de consulta awaitData para - indicar al servidor que bloquee durante un corto período (por ejemplo, un segundo) al final del conjunto de resultados antes de devolver una respuesta al controlador. Esto se utiliza para evitar que el controlador interrogue agresivamente - al servidor cuando no haya resultados disponibles. La opción - maxAwaitTimeMS puede ser utilizada conjuntamente con + Este ejemplo usa la opción de consulta awaitData para + instruir al servidor que bloquee durante un breve período (por ejemplo, + un segundo) al final del conjunto de resultados antes de devolver una + respuesta al controlador. Esto se usa para evitar que el controlador + consulte agresivamente al servidor cuando no hay resultados disponibles. + La opción maxAwaitTimeMS puede usarse junto con tailable y awaitData para especificar - la duración durante la cual el servidor debe bloquearse cuando alcance el final del conjunto de resultados. + la cantidad de tiempo que el servidor debe bloquearse cuando llega al final + del conjunto de resultados. @@ -268,18 +272,20 @@ while (true) {
&reftitle.errors; - Durante la iteración sobre el objeto Cursor, los datos BSON se convierten en variables PHP. Esta iteración puede provocar las siguientes excepciones: + Al iterar sobre el objeto cursor, los datos BSON se convierten en variables + PHP. Esta iteración puede causar las siguientes Excepciones: - Lanza una excepción + Lanza MongoDB\Driver\Exception\InvalidArgumentException si - una clase en el mapeo de tipo no puede ser instanciada o - no implementa MongoDB\BSON\Unserializable. + una clase en el mapa de tipos no puede ser instanciada o no implementa + MongoDB\BSON\Unserializable. &mongodb.throws.bson.unexpected;
+ &reference.mongodb.mongodb.driver.entities.cursor; diff --git a/reference/mongodb/mongodb/driver/cursorid.xml b/reference/mongodb/mongodb/driver/cursorid.xml index 44968ed8a..39901e6f2 100644 --- a/reference/mongodb/mongodb/driver/cursorid.xml +++ b/reference/mongodb/mongodb/driver/cursorid.xml @@ -1,7 +1,6 @@ - + - La clase MongoDB\Driver\CursorId @@ -12,20 +11,18 @@
&reftitle.intro; - - La clase MongoDB\Driver\CursorID es un objeto - valor que representa un identificador de cursor. - Las instancias de esta clase son devueltas por + + La clase MongoDB\Driver\CursorID es un objeto de valor + que representa un identificador de cursor. Las instancias de esta clase son devueltas por MongoDB\Driver\Cursor::getId. - + - - Esta clase ha sido DEPRECADA desde la versión - 1.20.0 de la extensión y ha sido eliminada en la versión 2.0. Las - aplicaciones deberían actualizar su uso de - MongoDB\Driver\Cursor::getId para devolver + + Esta clase ha sido DEPRECADA a partir de la versión 1.20.0 + de la extensión y fue eliminada en la versión 2.0. Las aplicaciones deben actualizar + su uso de MongoDB\Driver\Cursor::getId para devolver MongoDB\BSON\Int64 en su lugar. - +
@@ -33,11 +30,11 @@
&reftitle.classsynopsis; - + MongoDB\Driver\CursorId - + final @@ -63,39 +60,37 @@
&reftitle.changelog; - - - - - - &Version; - &Description; - - - - - - PECL mongodb 1.20.0 - - Esta clase ha sido deprecada y será eliminada en la versión 2.0. - - - - PECL mongodb 1.12.0 - - Implementa Stringable para PHP 8.0+. - - - - PECL mongodb 1.7.0 - - Implementa Serializable. - - - - - - + + + + + &Version; + &Description; + + + + &mongodb.changelog.class-removed; + + PECL mongodb 1.20.0 + + Esta clase ha sido deprecada y será eliminada en la versión 2.0. + + + + PECL mongodb 1.12.0 + + Implementa Stringable para PHP 8.0+. + + + + PECL mongodb 1.7.0 + + Implementa Serializable. + + + + +
diff --git a/reference/mongodb/mongodb/driver/cursorinterface.xml b/reference/mongodb/mongodb/driver/cursorinterface.xml index a48c6b64c..12e9605d3 100644 --- a/reference/mongodb/mongodb/driver/cursorinterface.xml +++ b/reference/mongodb/mongodb/driver/cursorinterface.xml @@ -1,8 +1,9 @@ - + - La interfaz MongoDB\Driver\CursorInterface + + La interfaz <literal>MongoDB\Driver\CursorInterface</literal> MongoDB\Driver\CursorInterface @@ -10,22 +11,22 @@
&reftitle.intro; - + Esta interfaz es implementada por - MongoDB\Driver\Cursor para ser utilizada como - tipo de argumento, de retorno o de propiedad en las clases de usuario. - + MongoDB\Driver\Cursor para ser usada como + un parámetro, retorno, o tipo de propiedad en clases de usuario. +
&reftitle.classsynopsis; - + MongoDB\Driver\CursorInterface - + MongoDB\Driver\CursorInterface @@ -46,32 +47,30 @@
&reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 2.0.0 - - - Esta interfaz ahora extiende Iterator. - - - Los tipos de retorno previamente declarados como tentativos ahora se aplican. - - - - &mongodb.changelog.tentative-return-types; - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 2.0.0 + + + Esta interfaz ahora extiende Iterator. + + + Los tipos de retorno declarados previamente como provisionales ahora están obligados. + + + + &mongodb.changelog.tentative-return-types; + + +
diff --git a/reference/mongodb/mongodb/driver/manager.xml b/reference/mongodb/mongodb/driver/manager.xml index a2bd4db33..0b2bb943b 100644 --- a/reference/mongodb/mongodb/driver/manager.xml +++ b/reference/mongodb/mongodb/driver/manager.xml @@ -1,7 +1,8 @@ - + + La clase MongoDB\Driver\Manager MongoDB\Driver\Manager @@ -10,21 +11,22 @@
&reftitle.intro; - - El MongoDB\Driver\Manager es el punto de entrada - principal de la extensión. Es responsable de mantener las conexiones a MongoDB - (ya sea un servidor autónomo, un conjunto de réplicas o un clúster compartido). - - - Ninguna conexión a MongoDB se establece durante la instanciación del Manager. - Esto significa que el MongoDB\Driver\Manager puede ser - construido siempre, incluso si uno o más servidores MongoDB están fuera de servicio. - - - Cualquier escritura o consulta puede lanzar excepciones de conexión ya que las conexiones se crean de manera perezosa. - Un servidor MongoDB también puede volverse indisponible durante la vida útil del script. - Por lo tanto, es importante que todas las acciones sobre el Manager estén envueltas en instrucciones try/catch. - + + La clase MongoDB\Driver\Manager es el punto de entrada + principal a la extensión. Es responsable de mantener las conexiones a MongoDB + (ya sea un servidor independiente, un conjunto de réplicas o un clúster particionado). + + + No se realiza ninguna conexión a MongoDB al instanciar el Manager. + Esto significa que el MongoDB\Driver\Manager siempre puede + ser construido, incluso si uno o más servidores de MongoDB están caídos. + + + Cualquier escritura o consulta puede lanzar excepciones de conexión ya que las conexiones + se crean de forma perezosa. Un servidor de MongoDB también puede volverse no disponible + durante la ejecución del script. Por lo tanto, es importante envolver todas las acciones + sobre el Manager en sentencias try/catch. +
@@ -55,14 +57,14 @@ &reftitle.examples; - Uso básico de <function>MongoDB\Driver\Manager::__construct</function> - - var_dump un - MongoDB\Driver\Manager mostrará diversos - detalles sobre el Manager que no están normalmente expuestos. - Esto puede ser útil para depurar cómo el controlador ve su configuración MongoDB, y + Ejemplo básico de <function>MongoDB\Driver\Manager::__construct</function> + + Realizar un var_dump de un + MongoDB\Driver\Manager mostrará varios detalles + sobre el gestor que normalmente no están expuestos. Esto puede ser útil + para depurar cómo el controlador visualiza su configuración de MongoDB y qué opciones se están utilizando. - + - - + - La clase MongoDB\Driver\Query @@ -13,21 +11,21 @@
&reftitle.intro; - - La clase MongoDB\Driver\Query es un objeto - que representa una consulta de base de datos. - + + La clase MongoDB\Driver\Query es un objeto de valor que + representa una consulta a la base de datos. +
&reftitle.classsynopsis; - + MongoDB\Driver\Query - + final diff --git a/reference/mongodb/mongodb/driver/server.xml b/reference/mongodb/mongodb/driver/server.xml index f8c2032ae..a452643df 100644 --- a/reference/mongodb/mongodb/driver/server.xml +++ b/reference/mongodb/mongodb/driver/server.xml @@ -1,7 +1,6 @@ - + - La clase MongoDB\Driver\Server @@ -12,20 +11,20 @@
&reftitle.intro; - + - +
&reftitle.classsynopsis; - + MongoDB\Driver\Server - + final @@ -102,7 +101,7 @@
- +
&reftitle.constants; @@ -110,82 +109,73 @@ MongoDB\Driver\Server::TYPE_UNKNOWN - Tipo de servidor desconocido, devuelto por MongoDB\Driver\Server::getType. + Tipo de servidor desconocido, devuelto por MongoDB\Driver\Server::getType. MongoDB\Driver\Server::TYPE_STANDALONE - Tipo de servidor autónomo, devuelto por MongoDB\Driver\Server::getType. + Tipo de servidor independiente, devuelto por MongoDB\Driver\Server::getType. MongoDB\Driver\Server::TYPE_MONGOS - Tipo de servidor Mongos, devuelto por MongoDB\Driver\Server::getType. + Tipo de servidor Mongos, devuelto por MongoDB\Driver\Server::getType. MongoDB\Driver\Server::TYPE_POSSIBLE_PRIMARY - Conjunto de réplicas tipo de servidor principal posible, devuelto por MongoDB\Driver\Server::getType. - Un servidor puede ser identificado como un posible primario si no ha sido verificado aún, pero otro miembro del conjunto de réplicas piensa que es el principal. + Tipo de servidor posible primario de conjunto de réplicas, devuelto por MongoDB\Driver\Server::getType. + Un servidor puede identificarse como posible primario si aún no ha sido verificado pero otro miembro del conjunto de réplicas cree que es el primario. MongoDB\Driver\Server::TYPE_RS_PRIMARY - Tipo de servidor principal del conjunto de réplicas, devuelto por MongoDB\Driver\Server::getType. + Tipo de servidor primario de conjunto de réplicas, devuelto por MongoDB\Driver\Server::getType. MongoDB\Driver\Server::TYPE_RS_SECONDARY - Réplica de tipo de servidor secundario, devuelto por MongoDB\Driver\Server::getType. + Tipo de servidor secundario de conjunto de réplicas, devuelto por MongoDB\Driver\Server::getType. MongoDB\Driver\Server::TYPE_RS_ARBITER - Tipo de servidor árbitro de conjunto de réplicas, devuelto por MongoDB\Driver\Server::getType. + Tipo de servidor árbitro de conjunto de réplicas, devuelto por MongoDB\Driver\Server::getType. MongoDB\Driver\Server::TYPE_RS_OTHER - Tipo de servidor otro de conjunto de réplicas, devuelto por MongoDB\Driver\Server::getType. - Estos servidores pueden estar ocultos, en proceso de inicio o en recuperación. No pueden ser consultados, pero sus listas de hosts son útiles para descubrir la configuración actual del conjunto de réplicas. + Tipo de servidor de conjunto de réplicas de otro tipo, devuelto por MongoDB\Driver\Server::getType. + Estos servidores pueden estar ocultos, iniciándose o recuperándose. No pueden ser consultados, pero sus listas de hosts son útiles para descubrir la configuración actual del conjunto de réplicas. MongoDB\Driver\Server::TYPE_RS_GHOST - Tipo de servidor fantasma de conjunto de réplicas, devuelto por MongoDB\Driver\Server::getType. - - Los servidores pueden ser identificados como tales en al menos tres - situaciones: brevemente durante el arranque del servidor; - en un conjunto de réplicas no inicializado; o cuando el servidor es evitado - (es decir, eliminado de la configuración del conjunto de réplicas). - No pueden ser consultados y su lista de hosts no puede - ser utilizada para descubrir la configuración actual del conjunto de - réplicas; sin embargo, el cliente puede monitorear este servidor con la esperanza - de que cambie a un estado más útil. - + Tipo de servidor fantasma de conjunto de réplicas, devuelto por MongoDB\Driver\Server::getType. + Los servidores pueden identificarse como tales en al menos tres situaciones: brevemente durante el inicio del servidor; en un conjunto de réplicas no inicializado; o cuando el servidor es rechazado (es decir, eliminado de la configuración del conjunto de réplicas). No pueden ser consultados, ni se puede usar su lista de hosts para descubrir la configuración actual del conjunto de réplicas; sin embargo, el cliente puede monitorear este servidor con la esperanza de que pase a un estado más útil. MongoDB\Driver\Server::TYPE_LOAD_BALANCER - Tipo de servidor de balanceo de carga, devuelto por MongoDB\Driver\Server::getType. + Tipo de servidor equilibrador de carga, devuelto por MongoDB\Driver\Server::getType. @@ -195,29 +185,27 @@
&reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 1.11.0 - - - Adición de la constante - MongoDB\Driver\Server::TYPE_LOAD_BALANCER. - - - - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 1.11.0 + + + Se añadió la constante + MongoDB\Driver\Server::TYPE_LOAD_BALANCER. + + + + + +
diff --git a/reference/mongodb/mongodb/driver/serverapi.xml b/reference/mongodb/mongodb/driver/serverapi.xml index 91232f623..038d15884 100644 --- a/reference/mongodb/mongodb/driver/serverapi.xml +++ b/reference/mongodb/mongodb/driver/serverapi.xml @@ -1,7 +1,8 @@ - + + La clase MongoDB\Driver\ServerApi MongoDB\Driver\ServerApi @@ -10,20 +11,20 @@
&reftitle.intro; - + - +
&reftitle.classsynopsis; - + MongoDB\Driver\ServerApi - + final @@ -53,7 +54,7 @@
- +
&reftitle.constants; @@ -61,7 +62,7 @@ MongoDB\Driver\ServerApi::V1 - Versión 1 de la API del servidor. + Versión 1 de la API del servidor. @@ -93,8 +94,8 @@ try { exit; } -/* La comando buildInfo devuelve un documento único, por lo que es necesario acceder - * al primer resultado del cursor. */ +/* El comando buildInfo devuelve un único documento de resultado, por lo que + * necesitamos acceder al primer resultado en el cursor. */ $buildInfo = $cursor->toArray()[0]; echo $buildInfo->version, "\n"; @@ -112,12 +113,13 @@ echo $buildInfo->version, "\n"; - Declarar una versión de API estricta en un gestor - - El siguiente ejemplo establece el flag strict, que - indica al servidor rechazar cualquier comando que no forme parte de la versión - de API declarada. Esto provoca un error al ejecutar el comando buildInfo. - + Declarar una versión estricta de API en un gestor + + El siguiente ejemplo establece la strict flag, que + indica al servidor que rechace cualquier comando que no forme parte de la + versión de API declarada. Esto genera un error al ejecutar el comando + buildInfo. + toArray()[0]; echo $buildInfo->version, "\n"; diff --git a/reference/mongodb/mongodb/driver/serverdescription.xml b/reference/mongodb/mongodb/driver/serverdescription.xml index edb88f5ef..6a6c703c4 100644 --- a/reference/mongodb/mongodb/driver/serverdescription.xml +++ b/reference/mongodb/mongodb/driver/serverdescription.xml @@ -1,7 +1,8 @@ - + + La clase MongoDB\Driver\ServerDescription MongoDB\Driver\ServerDescription @@ -10,24 +11,24 @@
&reftitle.intro; - - La clase MongoDB\Driver\ServerDescription es un objeto de valor - que representa un servidor al cual el controlador está conectado. Las instancias - de esta clase son devueltas por los métodos + + La clase MongoDB\Driver\ServerDescription es un objeto + valor que representa un servidor al que el controlador está conectado. Las + instancias de esta clase son devueltas por los métodos MongoDB\Driver\Server::getServerDescription y MongoDB\Driver\Monitoring\ServerChangedEvent. - +
&reftitle.classsynopsis; - + MongoDB\Driver\ServerDescription - + final @@ -104,7 +105,7 @@
- +
&reftitle.constants; @@ -112,73 +113,73 @@ MongoDB\Driver\ServerDescription::TYPE_UNKNOWN - El tipo de servidor desconocido, devuelto por MongoDB\Driver\ServerDescription::getType. + Tipo de servidor desconocido, devuelto por MongoDB\Driver\ServerDescription::getType. MongoDB\Driver\ServerDescription::TYPE_STANDALONE - El tipo de servidor autónomo, devuelto por MongoDB\Driver\ServerDescription::getType. + Tipo de servidor independiente, devuelto por MongoDB\Driver\ServerDescription::getType. MongoDB\Driver\ServerDescription::TYPE_MONGOS - El tipo de servidor Mongos, devuelto por MongoDB\Driver\ServerDescription::getType. + Tipo de servidor Mongos, devuelto por MongoDB\Driver\ServerDescription::getType. MongoDB\Driver\ServerDescription::TYPE_POSSIBLE_PRIMARY - El tipo de servidor primario posible de un conjunto de réplicas, devuelto por MongoDB\Driver\ServerDescription::getType. - Un servidor puede ser identificado como un primario posible si no ha sido verificado aún, pero otro servidor de la réplica piensa que es el primario. + Tipo de servidor posible primario de conjunto de réplicas, devuelto por MongoDB\Driver\ServerDescription::getType. + Un servidor puede ser identificado como posible primario si aún no ha sido verificado pero otro miembro del conjunto de réplicas considera que es el primario. MongoDB\Driver\ServerDescription::TYPE_RS_PRIMARY - El tipo de servidor primario de un conjunto de réplicas, devuelto por MongoDB\Driver\ServerDescription::getType. + Tipo de servidor primario de conjunto de réplicas, devuelto por MongoDB\Driver\ServerDescription::getType. MongoDB\Driver\ServerDescription::TYPE_RS_SECONDARY - El tipo de servidor secundario de un conjunto de réplicas, devuelto por MongoDB\Driver\ServerDescription::getType. + Tipo de servidor secundario de conjunto de réplicas, devuelto por MongoDB\Driver\ServerDescription::getType. MongoDB\Driver\ServerDescription::TYPE_RS_ARBITER - El tipo de servidor árbitro de un conjunto de réplicas, devuelto por MongoDB\Driver\ServerDescription::getType. + Tipo de servidor árbitro de conjunto de réplicas, devuelto por MongoDB\Driver\ServerDescription::getType. - MongoDB\Driver\ServerDescription::TYPE_RS_OTHER + MongoDB\Driver\ServerDescription::ServerDescription::TYPE_RS_OTHER - El tipo de servidor de un conjunto de réplicas distinto de primario, secundario o árbitro, devuelto por MongoDB\Driver\ServerDescription::getType. - Estos servidores pueden estar ocultos, iniciando o recuperándose. No pueden ser consultados, pero sus listas de hosts son útiles para descubrir la configuración actual del conjunto de réplicas. + Tipo de servidor de conjunto de réplicas de otro tipo, devuelto por MongoDB\Driver\ServerDescription::getType. + Estos servidores pueden estar ocultos, iniciándose o en recuperación. No pueden ser consultados, pero sus listas de hosts son útiles para descubrir la configuración actual del conjunto de réplicas. MongoDB\Driver\ServerDescription::TYPE_RS_GHOST - El tipo de servidor fantasma de un conjunto de réplicas, devuelto por MongoDB\Driver\ServerDescription::getType. - Los servidores pueden ser identificados como tales en al menos tres situaciones: brevemente durante el inicio del servidor; en un conjunto de réplicas no inicializado; o cuando el servidor es descartado (es decir, retirado de la configuración del conjunto de réplicas). No pueden ser consultados, ni su lista de hosts utilizada para descubrir la configuración actual del conjunto de réplicas; sin embargo, el cliente puede monitorear este servidor con la esperanza de que pase a un estado más útil. + Tipo de servidor fantasma de conjunto de réplicas, devuelto por MongoDB\Driver\ServerDescription::getType. + Los servidores pueden ser identificados como tales en al menos tres situaciones: brevemente durante el inicio del servidor; en un conjunto de réplicas no inicializado; o cuando el servidor es excluido (es decir, eliminado de la configuración del conjunto de réplicas). No pueden ser consultados, ni su lista de hosts puede usarse para descubrir la configuración actual del conjunto de réplicas; sin embargo, el cliente puede monitorear este servidor con la esperanza de que pase a un estado más útil. MongoDB\Driver\ServerDescription::TYPE_LOAD_BALANCER - El tipo de servidor equilibrador de carga, devuelto por MongoDB\Driver\ServerDescription::getType. + Tipo de servidor equilibrador de carga, devuelto por MongoDB\Driver\ServerDescription::getType. diff --git a/reference/mongodb/mongodb/driver/session.xml b/reference/mongodb/mongodb/driver/session.xml index 36fd36860..d5276b7b4 100644 --- a/reference/mongodb/mongodb/driver/session.xml +++ b/reference/mongodb/mongodb/driver/session.xml @@ -1,7 +1,8 @@ - + + La clase MongoDB\Driver\Session MongoDB\Driver\Session @@ -10,23 +11,23 @@
&reftitle.intro; - + La clase MongoDB\Driver\Session representa una - sesión cliente y es devuelta por + sesión de cliente y es devuelta por MongoDB\Driver\Manager::startSession. Los comandos, - las consultas y las operaciones de escritura pueden luego ser asociadas a la sesión. - + consultas y operaciones de escritura pueden entonces asociarse a la sesión. +
&reftitle.classsynopsis; - + MongoDB\Driver\Session - + final @@ -74,7 +75,7 @@
- +
&reftitle.constants; @@ -82,45 +83,45 @@ MongoDB\Driver\Session::TRANSACTION_NONE - - No hay transacción en curso. - + + No hay ninguna transacción en curso. + MongoDB\Driver\Session::TRANSACTION_STARTING - + Se ha iniciado una transacción, pero no se ha enviado ninguna operación al servidor. - + MongoDB\Driver\Session::TRANSACTION_IN_PROGRESS - - Una transacción está en curso. - + + Hay una transacción en curso. + MongoDB\Driver\Session::TRANSACTION_COMMITTED - - Una transacción ha sido validada. - + + La transacción se ha confirmado. + MongoDB\Driver\Session::TRANSACTION_ABORTED - - Una transacción ha sido anulada. - + + La transacción se ha abortado. + diff --git a/reference/mongodb/mongodb/driver/topologydescription.xml b/reference/mongodb/mongodb/driver/topologydescription.xml index cb9e48c1d..21cfc33ca 100644 --- a/reference/mongodb/mongodb/driver/topologydescription.xml +++ b/reference/mongodb/mongodb/driver/topologydescription.xml @@ -1,7 +1,8 @@ - + + La clase MongoDB\Driver\TopologyDescription MongoDB\Driver\TopologyDescription @@ -10,23 +11,23 @@
&reftitle.intro; - + La clase MongoDB\Driver\TopologyDescription es un - objeto de valor que representa una topología a la cual el controlador está - conectado. Las instancias de esta clase son devueltas por los métodos de + objeto valor que representa una topología a la que el controlador está conectado. + Las instancias de esta clase son devueltas por los métodos de MongoDB\Driver\Monitoring\TopologyChangedEvent. - +
&reftitle.classsynopsis; - + MongoDB\Driver\TopologyDescription - + final @@ -79,7 +80,7 @@
- +
&reftitle.constants; @@ -87,42 +88,42 @@ MongoDB\Driver\TopologyDescription::TYPE_UNKNOWN - Topología desconocida, devuelta por MongoDB\Driver\TopologyDescription::getType. + Tipo de topología desconocido, devuelto por MongoDB\Driver\TopologyDescription::getType. MongoDB\Driver\TopologyDescription::TYPE_SINGLE - Servidor único (es decir, conexión directa), devuelta por MongoDB\Driver\TopologyDescription::getType. + Servidor único (es decir, conexión directa), devuelto por MongoDB\Driver\TopologyDescription::getType. MongoDB\Driver\TopologyDescription::TYPE_SHARDED - Cluster compartido, devuelta por MongoDB\Driver\TopologyDescription::getType. + Agrupación particionada, devuelto por MongoDB\Driver\TopologyDescription::getType. MongoDB\Driver\TopologyDescription::TYPE_REPLICA_SET_NO_PRIMARY - Conjunto de réplicas sin servidor primario, devuelta por MongoDB\Driver\TopologyDescription::getType. + Conjunto de réplicas sin servidor primario, devuelto por MongoDB\Driver\TopologyDescription::getType. MongoDB\Driver\TopologyDescription::TYPE_REPLICA_SET_WITH_PRIMARY - Conjunto de réplicas con un servidor primario, devuelta por MongoDB\Driver\TopologyDescription::getType. + Conjunto de réplicas con un servidor primario, devuelto por MongoDB\Driver\TopologyDescription::getType. MongoDB\Driver\TopologyDescription::TYPE_LOAD_BALANCED - Topología equilibrada, devuelta por MongoDB\Driver\TopologyDescription::getType. + Topología con equilibrio de carga, devuelto por MongoDB\Driver\TopologyDescription::getType. @@ -153,6 +154,5 @@ sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si -vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->