(No version information available, might only be in Git)
Collection::replaceOne β Ersetzt ein Dokument einer Sammlung
Aktualisiert (oder ersetzt) das durch die ID angegebene Dokument, sofern es vorhanden ist.
id
Die ID des Dokuments, das ersetzt oder aktualisiert werden soll. Normalerweise ist dies die _id, die vom MySQL-Server beim HinzufΓΌgen des Datensatzes erzeugt wurde.
doc
Das Dokument, mit dem das zum Parameter id
gehΓΆrende Dokument aktualisiert oder ersetzt werden soll.
Dieses Dokument kann entweder ein Dokument-Objekt sein oder eine gΓΌltige JSON-Zeichenkette, die das neue Dokument beschreibt.
Gibt ein Result-Objekt zurΓΌck, das verwendet werden kann, um die Anzahl der betroffenen Elemente und die Anzahl der durch die Operation erzeugten Warnungen abzufragen.
Beispiel #1 mysql_xdevapi\Collection::replaceOne()-Beispiel
<?php
$session = mysql_xdevapi\getSession("mysqlx://user:password@localhost");
$session->sql("DROP DATABASE IF EXISTS addressbook")->execute();
$session->sql("CREATE DATABASE addressbook")->execute();
$schema = $session->getSchema("addressbook");
$collection = $schema->createCollection("people");
$result = $collection->add('{"name": "Alfred", "age": 18, "job": "Butler"}')->execute();
// Normalerweise ist die _id aus anderen Quellen bekannt, aber fΓΌr
// dieses Beispiel rufen wir die generierte ID ab und verwenden sie
$ids = $result->getGeneratedIds();
$alfred_id = $ids[0];
// ...
$alfred = $collection->getOne($alfred_id);
$alfred['age'] = 81;
$alfred['job'] = 'Guru';
$collection->replaceOne($alfred_id, $alfred);
?>