(無版本資訊,可能僅在 Git 中)
Collection::replaceOne — 取代一個集合文件
更新(或取代)由 ID 識別的文件(如果存在)。
id
要取代或更新的文件的 ID。通常這是 MySQL 伺服器在新增記錄時產生的 _id。
doc
要更新或取代符合 id 參數的文件之集合文件。
此文件可以是文件物件,也可以是描述新文件的有效 JSON 字串。
一個 Result 物件,可用於查詢受影響項目的數量以及操作產生的警告數量。
範例 #1 mysql_xdevapi\Collection::replaceOne() 範例
<?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();
// 通常 _id 會透過其他方式得知,
// 但在此範例中,讓我們取得產生的 id 並使用它
$ids = $result->getGeneratedIds();
$alfred_id = $ids[0];
// ...
$alfred = $collection->getOne($alfred_id);
$alfred['age'] = 81;
$alfred['job'] = 'Guru';
$collection->replaceOne($alfred_id, $alfred);
?>