# MongoDB\Driver\Manager::executeWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeWriteCommand — Exécute une commande de base de données qui écrit

### Description

final public MongoDB\Driver\Manager::executeWriteCommand(string `$db`, MongoDB\Driver\Command `$command`, ?array `$options` = `null`): MongoDB\Driver\Cursor

Exécute la commande sur le serveur primaire.

Cette méthode appliquera une logique spécifique aux commandes qui écrivent (par exemple » drop). Les valeurs par défaut de l'option `"writeConcern"` seront déduites à partir d'une transaction active (indiquée par l'option `"session"`), suivie de l'URI de connexion.

> Note: Cette méthode n'est pas destinée à être utilisée pour exécuter » insert, » update, ou » delete. Il est recommandé aux utilisateurs d'utiliser MongoDB\Driver\Manager::executeBulkWrite() pour ces opérations.

### Liste de paramètres

`db` (string)

  Le nom de la base de données sur laquelle la commande sera exécutée.

`command` (MongoDB\Driver\Command)

  La commande à exécuter.

`options`

  options
  Option | Type | Description
  --- | --- | ---
  session | MongoDB\Driver\Session | Une session à associer à l'opération.
  writeConcern | MongoDB\Driver\WriteConcern | Une préoccupation d'écriture à appliquer à l'opération.

  Avertissement

  Si vous utilisez une `"session"` qui a une transaction en cours, vous ne pouvez pas spécifier l'option `"readConcern"` ou `"writeConcern"`. Tenter de faire ceci lancera une exception MongoDB\Driver\Exception\InvalidArgumentException. À la place vous devriez définir ces options quand vous créez la transaction avec MongoDB\Driver\Session::startTransaction().

### Valeurs de retour

Retourne un MongoDB\Driver\Cursor en cas de succès.

### Erreurs / Exceptions

- Throws MongoDB\Driver\Exception\InvalidArgumentException if the `"session"` option is used with an associated transaction in combination with a `"readConcern"` or `"writeConcern"` option.
- Lance une exception MongoDB\Driver\Exception\InvalidArgumentException si l'option `"session"` est utilisée conjointement avec une préoccupation d'écriture non reconnu.
- Lance une exception MongoDB\Driver\AuthenticationException si une identification est nécessaire mais qu'elle échoue
- Lance une exception MongoDB\Driver\ConnectionException si la connexion au serveur échoue pour une autre raison qu'en raison d'un problème d'identification
- Lance une MongoDB\Driver\Exception\RuntimeException sur d'autre erreurs (par exemple: commande invalide).

### Historique

Version | Description
--- | ---
PECL mongodb 1.4.4 | Une MongoDB\Driver\Exception\InvalidArgumentException sera lancée si l'option `"session"` est utilisée en combinaison avec un `"writeConcern"` non reconnu.

### Voir aussi

- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Manager::executeCommand() - Exécute une commande de base de données
- MongoDB\Driver\Manager::executeReadCommand() - Exécute une commande de base de données qui lit
- MongoDB\Driver\Manager::executeReadWriteCommand() - Exécute une commande de base de données qui lit et écrit
- MongoDB\Driver\Server::executeWriteCommand() - Exécute une commande de base de données qui écrit sur ce serveur