PHP Conference Japan 2024

Collection::replaceOne

(無版本資訊,可能僅在 Git 中)

Collection::replaceOne取代一個集合文件

描述

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

更新(或取代)由 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);

?>
新增筆記

使用者貢獻的筆記

此頁面沒有使用者貢獻的筆記。
To Top