Collection::replaceOne()()
替换集合中符合条件的第一个文档
函数名：Collection::replaceOne()
函数版本：PHP 7.4.0 或更高版本
用法：Collection::replaceOne() 方法用于替换集合中符合条件的第一个文档。
语法：
public function replaceOne($filter, $replacement, array $options = []): ?object
参数：
$filter：一个文档，用于筛选需要替换的文档。
$replacement：一个文档，用于替换被筛选文档。
$options（可选）：一个关联数组，用于指定额外的选项。
返回值：
如果替换成功，返回被替换的文档对象；如果未找到匹配的文档，返回null。
示例：
假设我们有一个名为"users"的集合，其中存储了用户信息文档。现在我们想替换用户名为"John"的用户的年龄为30。
<?php
$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");
$collection = new MongoDB\Collection($manager, "dbName", "users");
$filter = [
"name" => "John"
];
$replacement = [
"name" => "John",
"age" => 30
];
$result = $collection->replaceOne($filter, $replacement);
if ($result) {
echo "替换成功！";
} else {
echo "未找到匹配的文档。";
}
?>
在上面的例子中，我们首先创建一个 MongoDB\Driver\Manager 对象来与 MongoDB 服务器建立连接。然后，我们使用这个对象创建一个 MongoDB\Collection 对象来引用指定的集合。接下来，我们定义了一个筛选器 $filter，它用于找到用户名为"John"的用户文档。然后，我们定义了一个替换文档 $replacement，它指定了要替换的用户名和年龄。最后，我们调用了 Collection::replaceOne() 方法来替换第一个匹配到的文档，并根据返回结果输出相应的信息。