(mongodb >=2.1.0)
MongoDB\Driver\BulkWriteCommand::updateMany — Añade una operación updateMany
$namespace,$filter,$update,$options = null
Añade una operación updateMany a la
MongoDB\Driver\BulkWriteCommand. Todos los documentos
que coincidan con filter en la colección identificada por
namespace serán actualizados.
namespace (string)
Un espacio de nombres completamente calificado (ej. "databaseName.collectionName")
filter (array|object)El » atributo de la consulta. Un atributo vacío hará coincidir todos los documentos de la colección.
Nota: Al evaluar los criterios de consulta, MongoDB compara los tipos y los valores según sus propias » reglas de comparación para los tipos BSON, que difieren de las reglas de comparación y de manipulación de tipos de PHP. Al hacer coincidir un tipo BSON especial, los criterios de consulta deben utilizar la clase BSON (ej. : utilizar MongoDB\BSON\ObjectId para hacer coincidir un » ObjectId).
update (array|object)
Un documento que contiene operadores de actualización (por ejemplo
$set) o una
» pipeline de agregación.
options
| Opción | Tipo | Descripción | Por omisión |
|---|---|---|---|
| arrayFilters | array |
Un array de documentos de filtro que determina qué elementos de array modificar para una operación de actualización en un campo de array. Consulte » Especificar arrayFilters para operaciones de actualización de array en el manual de MongoDB para obtener más información. |
|
| collation | array|object |
» Collation permite a los usuarios especificar reglas específicas del lenguaje para la comparación de cadenas, por ejemplo, reglas para mayúsculas o acentos. Al especificar una collation, el campo Si la collation no es especificada pero la colección tiene una collation por omisión, la operación utilizará la collation especificada para la colección. Si ninguna collation es especificada para la colección o para la operación, MongoDB utilizará el binario simple de comparación utilizado en versiones anteriores para las comparaciones de cadenas. Esta opción está disponible en MongoDB 3.4+ y una excepción será emitida en tiempo de ejecución si es especificada en una versión anterior. |
|
| hint | string|array|object |
Especificación del índice. Especifique el nombre del índice como string o mediante el patrón de clave del índice. Si se especifica, el sistema de consulta solo considerará los planes que utilicen el índice sugerido. |
|
| upsert | bool |
Si filter no coincide con ningún documento existente,
insertar un documento single. El documento será creado
aplicando los operadores en update a todos
los valores de campo en filter.
|
false |
No se retorna ningún valor.
Ejemplo #1 Ejemplo 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);
?>