array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'uk', ), 'this' => array ( 0 => 'mongodb-driver-bulkwritecommand.updatemany.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand::updateMany', 2 => 'Add an updateMany operation', ), 'up' => array ( 0 => 'class.mongodb-driver-bulkwritecommand.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand', ), 'prev' => array ( 0 => 'mongodb-driver-bulkwritecommand.replaceone.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand::replaceOne', ), 'next' => array ( 0 => 'mongodb-driver-bulkwritecommand.updateone.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand::updateOne', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/mongodb/mongodb/driver/bulkwritecommand/updatemany.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

MongoDB\Driver\BulkWriteCommand::updateMany

(mongodb >=2.1.0)

MongoDB\Driver\BulkWriteCommand::updateMany — Add an updateMany operation

Опис

public MongoDB\Driver\BulkWriteCommand::updateMany(
    string $namespace,
    array|object $filter,
    array|object $update,
    ?array $options = null
): void

Add an updateMany operation to the MongoDB\Driver\BulkWriteCommand. All documents matching filter in the collection identified by namespace will be updated.

Параметри

namespace (string)

Повна назва простору імен (напр. "databaseName.collectionName").

filter (array|object)

» Предикат запиту. Порожній предикат відповідає всім документам у колекції.

Зауваження: Під час виконання критеріїв запиту MongoDB порівнює типи та значення за власними » правилами порівняння BSON-типів, що відрізняється від правил порівняння і перетворення типів в PHP. Для вибірки даних спеціальних BSON-типів, критерії запиту повинні використовувати відповідний клас BSON (напр. MongoDB\BSON\ObjectId для вибірки » ObjectId).

update (array|object)

A document containing either update operators (e.g. $set) or an » aggregation pipeline.

options

options
Option Type Description Default
arrayFilters array

An array of filter documents that determines which array elements to modify for an update operation on an array field. See » Specify arrayFilters for Array Update Operations in the MongoDB manual for more information.

collation array|object

» Зіставлення дозволяє вказувати специфічні для мови правила порівняння рядків, як от правила регістру та знаків наголосу. Під час визначення зіставлень поле "locale" є обов'язковим, а всі інші поля — ні. Опис полів є на сторінці » Документ зіставлення.

Якщо зіставлення не вказано, то використовується стандартне зіставлення для колекції, якщо воно вказано. Якщо ж ні, MongoDB використовує просте двійкове порівняння, яке використовувалося в попередніх версіях для порівняння рядків.

Цей параметр доступний у MongoDB 3.4+, тож його застосування у старіших версіях викине виключення під час виконання.

hint string|array|object

Index specification. Specify either the index name as a string or the index key pattern. If specified, then the query system will only consider plans using the hinted index.

upsert bool If filter does not match an existing document, insert a single document. The document will be created by applying operators in update to any field values in filter. false

Значення, що повертаються

Не повертає значень.

Помилки/виключення

Приклади

Приклад #1 MongoDB\Driver\BulkWriteCommand::updateMany() example

<?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);

?>

Прогляньте також