检索数据

示例数据

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

$collection = $client->sample_training->companies;

要了解如何创建免费的MongoDB Atlas集群并加载示例数据集，请参阅使用Atlas入门指南。

查找单个文档

要在一个集合中查找单个文档，请调用 MongoDB\Collection::findOne() 方法，并传递一个查询过滤器，该过滤器指定了要查找的文档的条件。

findOne() 方法返回一个 array、object 或 null 值。如果查询过滤器匹配一个文档，该方法返回一个包含该文档的 array|object 实例。返回类型取决于 typeMap 选项的值。如果查询过滤器没有匹配任何文档，则返回 null。

如果查询过滤器匹配多个文档，则 findOne() 方法返回检索结果中的 第一个 匹配文档。

以下示例使用 findOne() 方法查找第一个 name 字段值为 'LinkedIn' 的文档。

$document = $collection->findOne(['name' => 'LinkedIn']);
echo json_encode($document), PHP_EOL;

{"_id":{"$oid":"..."},"name":"LinkedIn","permalink":"linkedin","crunchbase_url":
"http:\/\/www.crunchbase.com\/company\/linkedin","homepage_url":"http:\/\/linkedin.com",
... }

查找多个文档

要在一个集合中查找多个文档，请将查询过滤器传递给 MongoDB\Collection::find() 方法，该过滤器指定了要检索的文档的条件。

以下示例使用 find() 方法来查找所有在 founded_year 字段值为 1970 的文档。

$results = $collection->find(['founded_year' => 1970]);

find() 方法返回一个 MongoDB\Driver\Cursor 实例，您可以通过迭代来查看匹配的文档。游标是一种机制，允许应用程序在给定时间内存中仅保留数据库结果的一个子集的情况下迭代数据库结果。当您的 find() 方法返回大量文档时，游标非常有用。

您可以使用 foreach 循环迭代游标中的文档，如下面的示例所示。

foreach ($results as $doc) {
    echo json_encode($doc), PHP_EOL;
}

{"_id":{"$oid":"..."},"name":"Mitsubishi Motors","permalink":"mitsubishi-motors",
"crunchbase_url":"http:\/\/www.crunchbase.com\/company\/mitsubishi-motors",
... }
{"_id":{"$oid":"..."},"name":"Western Digital","permalink":"western-digital",
"crunchbase_url":"http:\/\/www.crunchbase.com\/company\/western-digital",
... }
{"_id":{"$oid":"..."},"name":"Celarayn","permalink":"celarayn","crunchbase_url":
"http:\/\/www.crunchbase.com\/company\/celarayn",
... }

$cursor = $collection->find([]);

修改查找行为

您可以通过传递一个指定选项值的数组作为参数来修改 MongoDB\Collection::find() 和 MongoDB\Collection::findOne() 方法的行为。以下表格描述了您可以在数组中设置的某些选项。

以下示例使用 find() 方法查找所有在 number_of_employees 字段值为 1000 的文档。示例使用 limit 选项返回最多 5 个结果。

$results = $collection->find(
    ['number_of_employees' => 1000],
    ['limit' => 5]
);
foreach ($results as $doc) {
    echo json_encode($doc), PHP_EOL;
}

有关选项的完整列表，请参阅 findOne() 和 find() 的 API 文档。

API 文档

要了解更多关于本指南中讨论的任何方法，请参阅以下API文档

• MongoDB\Collection::findOne()

• MongoDB\Collection::find()