(mongodb >=2.1.0)
MongoDB\Driver\BulkWriteCommand::replaceOne — Add a replaceOne operation
$namespace,$filter,$replacement,$options = null
Add a replaceOne operation to the
MongoDB\Driver\BulkWriteCommand. The first document
matching filter in the collection identified by
namespace will be replaced.
namespace (string)
Повна назва простору імен (напр.
"databaseName.collectionName").
filter
(array|object)» Предикат запиту. Порожній предикат відповідає всім документам у колекції.
Зауваження: Під час виконання критеріїв запиту MongoDB порівнює типи та значення за власними » правилами порівняння BSON-типів, що відрізняється від правил порівняння і перетворення типів в PHP. Для вибірки даних спеціальних BSON-типів, критерії запиту повинні використовувати відповідний клас BSON (напр. MongoDB\BSON\ObjectId для вибірки » ObjectId).
replacement (array|object)A replacement document.
options
| Option | Type | Description | Default |
|---|---|---|---|
| collation | array|object |
» Зіставлення
дозволяє вказувати специфічні для мови правила порівняння рядків,
як от правила регістру та знаків наголосу. Під час визначення
зіставлень поле Якщо зіставлення не вказано, то використовується стандартне зіставлення для колекції, якщо воно вказано. Якщо ж ні, 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. |
|
| sort | array|object |
Specify which document the operation replaces if the query matches multiple documents. The first document matched by the sort order will be replaced. |
|
| upsert | bool |
If filter does not match an existing document,
insert a single document. The document will be
created from replacement.
|
false |
Не повертає значень.
Приклад #1 MongoDB\Driver\BulkWriteCommand::replaceOne() example
<?php
$manager = new MongoDB\Driver\Manager;
$bulk = new MongoDB\Driver\BulkWriteCommand;
$bulk->replaceOne('db.coll', ['x' => 1], ['x' => 1, 'y' = 2]);
$result = $manager->executeBulkWriteCommand($bulk);
?>