Ersetzt ein Dokument einer Sammlung

# Collection::replaceOne

(No version information available, might only be in Git)

Collection::replaceOne — Ersetzt ein Dokument einer Sammlung

### Beschreibung

public function mysql_xdevapi\Collection::replaceOne(string `$id`, string `$doc`): mysql_xdevapi\Result

Aktualisiert (oder ersetzt) das durch die ID angegebene Dokument, sofern es vorhanden ist.

### Parameter-Liste

`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.

### Rückgabewerte

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.

### Beispiele

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

    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open