MongoDB\Driver\WriteConcern::__construct

(mongodb >=1.0.0)

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

Description

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

Construit un nouveau MongoDB\Driver\WriteConcern, qui est un objet de valeur immuable.

Liste de paramĂštres

w

Write concern
Valeur Description
1 Demande l'accusé de réception que l'opération d'écriture s'est propagée au mongod autonome ou au principal dans un jeu de réplicas. Il s'agit du write concern par défaut pour MongoDB.
0 Ne demande aucun accusé de réception de l'opération d'écriture. Toutefois, cela peut renvoyer des informations sur les exceptions de socket et les erreurs de mise en réseau à l'application.
<entier supérieur à 1> Les nombres supérieurs à 1 sont valides uniquement pour les jeux de réplicas pour demander l'accusé de réception à partir du nombre spécifié de membres, y compris le principal.
MongoDB\Driver\WriteConcern::MAJORITY Demande l'accusĂ© de rĂ©ception que les opĂ©rations d'Ă©criture se sont propagĂ©es Ă  la majoritĂ© des nƓuds votants, y compris le principal, et ont Ă©tĂ© Ă©crites dans le journal sur disque pour ces nƓuds. Avant MongoDB 3.0, il s'agit de la majoritĂ© des membres du jeu de rĂ©plicas (et pas seulement des nƓuds votants).
string Une valeur de chaßne est interprétée comme un jeu de balises. Demande l'accusé de réception que les opérations d'écriture se sont propagées à un membre de jeu de réplicas avec la balise spécifiée.
wtimeout
DĂ©lai d'attente maximal (en millisecondes) avant que les secondaires n'Ă©chouent. wtimeout fera que les opĂ©rations en Ă©criture vont retourner une erreur (WriteConcernError) aprĂšs le dĂ©lai spĂ©cifiĂ©, mĂȘme si le write concern requis finit par ĂȘtre satisfait. Lorsque ces opĂ©rations en Ă©criture retournent, MongoDB ne va pas annuler les modifications de donnĂ©es rĂ©ussies effectuĂ©es avant que le write concern n'ait dĂ©passĂ© le dĂ©lai limite wtimeout. Si spĂ©cifiĂ©, wtimeout doit ĂȘtre un entier signĂ© 64 bits supĂ©rieur ou Ă©gal Ă  zĂ©ro.

Délai d'attente du write concern
Valeur Description
0 Bloc indéfiniment. C'est le comportement par défaut.
<entier supérieur à 0> Nombre de millisecondes à attendre avant de retourner.
journal
Attente avant que mongod n'applique l'écriture au journal.

Erreurs / Exceptions

  • Lance une exception MongoDB\Driver\InvalidArgumentException lors d'une erreur survenue pendant l'analyse d'un argument.
  • LĂšve une exception MongoDB\Driver\Exception\InvalidArgumentException si w est invalide ou wtimeout est nĂ©gatif ou supĂ©rieure aux limites d'un entier signĂ© 32 bits.

Historique

Version Description
PECL mongodb 1.7.0 Le paramÚtre wTimeout accepte désormais des valeurs 64-bit.

Exemples

Exemple #1 Exemple avec MongoDB\Driver\WriteConcern::__construct()

<?php

/* Demande une confirmation des requĂȘtes en Ă©criture pour la majoritĂ© des nƓuds
du jeux de réplication */
$wc = new MongoDB\Driver\WriteConcern(MongoDB\Driver\WriteConcern::MAJORITY, 500);

/* Demande une confirmation des requĂȘtes en Ă©criture, configurĂ©e par la balise
"MultipleDC" */
$wc = new MongoDB\Driver\WriteConcern("MultipleDC", 500);

?>
add a note

User Contributed Notes

There are no user contributed notes for this page.