Descripción

final public MongoDB\Driver\WriteConcern::__construct(string|int $w, ?int $wtimeout = null, ?bool $journal = null)

Construye un nuevo MongoDB\Driver\WriteConcern, que es un objeto de valor inmutable.

Parámetros

w

Preocupación de escritura

Valor Descripción

1 Solicita el acuse de recibo de que la operación de escritura se ha propagado al mongod autónomo o al principal en un conjunto de réplicas. Es la preocupación de escritura por omisión para MongoDB.

0 No solicita ningún acuse de recibo de la operación de escritura. Sin embargo, puede devolver información sobre las excepciones de socket y los errores de red a la aplicación.

<entero superior a 1> Los números superiores a 1 son válidos únicamente para los conjuntos de réplicas para solicitar el acuse de recibo del número especificado de miembros, incluyendo el principal.

MongoDB\Driver\WriteConcern::MAJORITY
Solicita el acuse de recibo de que las operaciones de escritura se han propagado a la mayoría de los nodos votantes, incluyendo el principal, y han sido escritas en el journal en disco para esos nodos.

Antes de MongoDB 3.0, es la mayoría de los miembros del conjunto de réplicas (y no solo de los nodos votantes).

string Un valor de string es interpretado como un conjunto de etiquetas. Solicita el acuse de recibo de que las operaciones de escritura se han propagado a un miembro del conjunto de réplicas con la etiqueta especificada.

wtimeout

**Preocupación de escritura**
Valor	Descripción
1	Solicita el acuse de recibo de que la operación de escritura se ha propagado al `mongod` autónomo o al principal en un conjunto de réplicas. Es la preocupación de escritura por omisión para MongoDB.
0	No solicita ningún acuse de recibo de la operación de escritura. Sin embargo, puede devolver información sobre las excepciones de socket y los errores de red a la aplicación.
<entero superior a 1>	Los números superiores a 1 son válidos únicamente para los conjuntos de réplicas para solicitar el acuse de recibo del número especificado de miembros, incluyendo el principal.
`MongoDB\Driver\WriteConcern::MAJORITY`	Solicita el acuse de recibo de que las operaciones de escritura se han propagado a la mayoría de los nodos votantes, incluyendo el principal, y han sido escritas en el journal en disco para esos nodos. Antes de MongoDB 3.0, es la mayoría de los miembros del conjunto de réplicas (y no solo de los nodos votantes).
string	Un valor de string es interpretado como un conjunto de etiquetas. Solicita el acuse de recibo de que las operaciones de escritura se han propagado a un miembro del conjunto de réplicas con la etiqueta especificada.

Tiempo máximo de espera (en milisegundos) antes de que los secundarios fallen.

wtimeout hará que las operaciones de escritura devuelvan un error (WriteConcernError) después del tiempo especificado. Cuando estas operaciones de escritura devuelvan, MongoDB no cancelará los datos modificados antes de que las preocupaciones de escritura alcancen el tiempo límite wtimeout.

Si se especifica, wtimeout debe ser un entero con signo de 64 bits mayor o igual a cero.

Tiempo máximo de espera de las preocupaciones de escritura

Valor Descripción

0 Bloquea indefinidamente. Es el comportamiento por omisión.

<entero superior a 0> Número de milisegundos a esperar antes de devolver.

journal

**Tiempo máximo de espera de las preocupaciones de escritura**
Valor	Descripción
0	Bloquea indefinidamente. Es el comportamiento por omisión.
<entero superior a 0>	Número de milisegundos a esperar antes de devolver.

Espera antes de que mongod aplique la escritura al journal.

Errores/Excepciones

Lanza una excepción MongoDB\Driver\InvalidArgumentException en caso de error durante el análisis de un argumento.
Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si w es inválido o wtimeout es negativo o superior a los límites de un entero con signo de 32 bits.

Historial de cambios

Versión Descripción

PECL mongodb 1.7.0 El parámetro wTimeout acepta ahora valores de 64 bits.

Versión	Descripción
PECL mongodb 1.7.0	El parámetro `wTimeout` acepta ahora valores de 64 bits.

Ejemplos

Ejemplo #1 Ejemplo con MongoDB\Driver\WriteConcern::__construct()

<?php

/* Solicita una confirmación de las solicitudes de escritura para la mayoría de los nodos
   del conjunto de réplicas */
$wc = new MongoDB\Driver\WriteConcern(MongoDB\Driver\WriteConcern::MAJORITY, 500);

/* Solicita una confirmación de las solicitudes de escritura, configurada por la etiqueta
   "MultipleDC" */
$wc = new MongoDB\Driver\WriteConcern("MultipleDC", 500);

?>

Ver también

» Write Concern reference