Construye un WriteConcern

# MongoDB\Driver\WriteConcern::__construct

(mongodb >=1.0.0)

MongoDB\Driver\WriteConcern::__construct — Construye un WriteConcern

### Descripción

final public function 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`
  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`
  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.

### 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open