(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)
A fully qualified namespace (e.g. "databaseName.collectionName").
filter (array|object)Das » Abfrage-Prädikat. Ein leeres Prädikat passt auf alle Dokumente in der Sammlung.
Hinweis: Bei der Auswertung von Abfragekriterien vergleicht MongoDB Typen und Werte gemäß seiner eigenen » Vergleichsregeln für BSON-Typen, die sich von PHPs Regeln für Typenvergleich und Typen-Jonglage unterscheidet. Wenn es eine Übereinstimmung mit einem speziellen BSON-Typ gibt, sollten die Abfragekriterien die entsprechende BSON-Klasse verwenden (z. B. MongoDB\BSON\ObjectId, um auf eine » ObjectId zu passen).
replacement (array|object)A replacement document.
options
| Option | Type | Description | Default |
|---|---|---|---|
| collation | array|object |
Die » Collation (Vergleichs-/Sortierregel) ermöglicht es dem Benutzer, sprachspezifische Regeln für den Vergleich von Zeichenketten anzugeben, so z. B. Regeln für die Groß- und Kleinschreibung und Akzentzeichen. Bei der Angabe der Sortierung ist das Feld Wenn keine Kollation angegeben wurde, aber die Sammlung eine Standardkollation hat, verwendet die Operation die für die Sammlung angegebene Kollation. Wenn weder für die Sammlung noch für die Operation eine Kollation angegeben wurde, verwendet MongoDB den einfachen binären Vergleich, der in früheren Versionen für den Vergleich von Zeichenketten verwendet wurde. Diese Option ist ab MongoDB 3.4 verfügbar. Wenn sie für eine ältere Serverversion angegeben wird, kommt es bei der Ausführung zu einer Exception. |
|
| 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 |
Es wird kein Wert zurückgegeben.
Beispiel #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);
?>