/ /

插入文档

Overview

在本指南中，您可以学习；了解如何使用MongoDB PHP库通过执行插入操作将文档添加到MongoDB集合。

插入操作将一个或多个文档插入MongoDB集合。您可以使用以下方法执行插入操作：

MongoDB\Collection::insertOne() 插入单个文档的方法
MongoDB\Collection::insertMany() 插入一个或多个文档的方法

样本数据

本指南中的示例使用Atlas示例数据集的sample_restaurants数据库中的restaurants集合。要从PHP应用程序访问权限此集合，请实例化一个连接到Atlas 集群的MongoDB\Client ，并将以下值分配给$collection变量：

$collection = $client->sample_restaurants->restaurants;

要学习如何创建免费的MongoDB 部署并加载示例数据集，请参阅MongoDB 入门指南。

`_id` 字段

在 MongoDB 集合中，每个文档必须包含具有唯一字段值的 _id 字段。

MongoDB 允许您通过两种方式管理该字段：

自行为每个文档设置_id字段，确保每个值都是唯一的。
让驱动程序自动为每个文档_id字段生成唯一的 ObjectId 值。

除非您可以保证唯一性，否则我们建议让驱动程序自动生成_id值。

注意

重复的 _id 值违反了唯一索引约束，导致驱动程序返回 MongoDB\Driver\Exception\BulkWriteException 错误。

要了解有关_id字段的更多信息，请参阅 MongoDB Server 手册中的唯一索引指南。

要了解有关文档结构和规则的更多信息，请参阅 MongoDB Server 手册中的文档指南。

插入一个文档

要将单个文档添加到 MongoDB 集合，请调用MongoDB\Collection::insertOne()方法并传递要添加的文档。

以下示例将文档插入restaurants集合：

$result = $collection->insertOne(['name' => 'Mongo\'s Burgers']);

插入多个文档

要将多个文档添加到MongoDB集合，请调用MongoDB\Collection::insertMany()方法并传递包含要添加的文档列表的大量。

以下示例将两个文档插入restaurants集合：

$restaurants = [
    ['name' => 'Mongo\'s Burgers'],
    ['name' => 'Mongo\'s Pizza'],
];
$result = $collection->insertMany($restaurants);

修改插入行为

您可以通过将指定选项值的大量作为参数传递来修改MongoDB\Collection::insertOne()和MongoDB\Collection::insertMany()方法的行为。下表描述了您可以在大量中设立的一些选项：

字段	说明
`bypassDocumentValidation`	如果设立为`true` ，则允许写入操作选择退出文档级验证。默认为。类型： `false` `bool`
`writeConcern`	设置操作的写关注（write concern）。默认为命名空间的写关注（write concern）。类型： `MongoDB\Driver\WriteConcern`
`ordered`	如果设立为`true` ，则该操作会在一次插入失败时停止插入文档。如果为`false` ，则当一次插入失败时，该操作将继续插入剩余文档。您不能将此选项传递给方法。默认为`insertOne()` `true` 。类型：`bool`
`comment`	要附加到操作的注释。有关更多信息，请参阅MongoDB Server手册中的插入命令字段指南。类型：任何有效的BSON类型

例子

以下代码使用insertMany()方法将三个新文档插入到集合中。由于选项大量中的bypassDocumentValidation字段设立为true ，因此此插入操作会绕过文档级验证：

$docs = [
    ['name' => 'Mongo\'s Burgers'],
    ['name' => 'Mongo\'s Pizza'],
    ['name' => 'Mongo\'s Tacos'],
];
$result = $collection->insertMany($docs, ['bypassDocumentValidation' => true]);