(mongodb >=2.1.0)
MongoDB\Driver\BulkWriteCommand::updateMany — Ajoute une opération updateMany
$namespace,$filter,$update,$options = null
Ajoute une opération updateMany à la
MongoDB\Driver\BulkWriteCommand. Tous les documents
correspondant à filter dans la collection identifiée par
namespace seront mis à jour.
namespace (string)
Un espace de noms totalement qualifié (e.g. "databaseName.collectionName")
filter (array|object)L'» attribut de la requête. Un attribut vide va faire correspondre tous les documents de la collection.
Note: Lors de l'évaluation des critères de requête, MongoDB compare les type et les valeurs en fonction de leur propre » règles de comparaison pour les types BSON, qui diffère des règles de comparaison et de manipulation des type de PHP. Lors de la correspondance d'un type BSON spcécial, les critères de requête doivent utiliser la classe BSON (ex. : utiliser MongoDB\BSON\ObjectId pour correspondre à un » ObjectId).
update (array|object)
Un document contenant soit des opérateurs de mise à jour (par exemple
$set) ou une
» pipeline d'aggregation.
options
| Option | Type | Description | Défaut |
|---|---|---|---|
| arrayFilters | array |
Un tableau de documents de filtre qui détermine quels éléments de tableau à modifier pour une opération de mise à jour sur un champ de tableau. Voir » Spécifier arrayFilters pour les opérations de mise à jour de tableau dans le MongoDB manual pour plus d'informations. |
|
| collation | array|object |
» Collation permet aux utilisateurs de spécifier des règles spécifiques au langage pour la comparaison des chaînes, par exemple, des règles pour les majuscules ou les accents. Lors de la spécification d'une collation, le champ Si la collation n'est pas spécifiée mais que la collection a une collation par défaut, l'opération utilisera la collation spécifiée pour la collection. Si aucune collation n'est spécifiée pour la collection ou pour l'opération, MongoDB utilisera le binaire simple de comparaison utilisé dans les versions précédentes pour les comparaisons des chaînes. Cette option est disponible en MongoDB 3.4+ et une exception sera émise au moment de l'exécution si elle est spécifiée dans une version antérieure. |
|
| hint | string|array|object |
Spécification de l'index. Spécifiez soit le nom de l'index sous forme de chaîne ou par le modèle de clé de l'index. Si spécifié, le système de requête ne considérera que les plans utilisant l'index suggéré. |
|
| upsert | bool |
Si filter ne correspond à aucun document existant,
insérer un document single. Le document sera créé
en appliquant les opérateurs dans update à toutes
les valeurs de champ dans filter.
|
false |
Aucune valeur n'est retournée.
Exemple #1 Exemple de MongoDB\Driver\BulkWriteCommand::updateMany()
<?php
$manager = new MongoDB\Driver\Manager;
$bulk = new MongoDB\Driver\BulkWriteCommand;
$bulk->updateMany('db.coll', ['x' => ['$gt' => 1]], ['$set' => ['y' => 2]]);
$result = $manager->executeBulkWriteCommand($bulk);
?>