MongoDB\Driver\BulkWrite::insert()函数—用法及示例

函数名称：MongoDB\Driver\BulkWrite::insert()

适用版本：MongoDB PHP 扩展版本 1.0.0 及以上

函数描述：该函数用于向 MongoDB 数据库的集合中插入一个或多个文档。

用法：

public function insert(array|object $document): void

参数：

• $document (array|object)：要插入的文档，可以是一个关联数组或一个对象。

返回值：无返回值。

示例：

// 连接到 MongoDB 服务器
$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");

// 选择要操作的数据库和集合
$database = "mydb";
$collection = "mycollection";

// 创建一个 BulkWrite 对象
$bulk = new MongoDB\Driver\BulkWrite;

// 要插入的文档
$document1 = array("name" => "John", "age" => 30);
$document2 = array("name" => "Jane", "age" => 25);

// 插入文档到集合中
$bulk->insert($document1);
$bulk->insert($document2);

// 执行插入操作
$result = $manager->executeBulkWrite("$database.$collection", $bulk);

// 检查插入操作是否成功
if ($result->getInsertedCount() > 0) {
    echo "文档插入成功！";
} else {
    echo "文档插入失败！";
}

注意事项：

• 在执行插入操作之前，需要先通过 MongoDB\Driver\Manager 类连接到 MongoDB 服务器。
• 需要先选择要操作的数据库和集合。
• 可以通过创建一个 MongoDB\Driver\BulkWrite 对象来批量插入多个文档。
• 插入操作成功后，可以通过 $result->getInsertedCount() 方法获取插入的文档数量。
• 如果插入操作失败，可以通过捕获异常来处理错误情况。