Retrieve Data

样本数据

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

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

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

查找一个文档

要查找集合中的单个文档，请调用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()