对于 AI 代理：可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单
Docs 主页
/ /
PHP库
Docs 主页
/
客户端库
/
PHP
/
PHP库
Docs 主页
/
客户端库
/
PHP
/
PHP库

指定要返回的文档

Overview

在本指南中，您可以学习；了解如何通过将以下选项传递给MongoDB\Collection::find()或MongoDB\Collection::findOne()方法来指定从读取操作中返回哪些文档和类型：

  • limit ：指定查询返回的最大文档数

  • sort ：指定返回文档的排序顺序

  • skip ：指定在返回查询结果之前要跳过的文档数

  • typeMap ：将返回的文档转换为指定的数据类型

样本数据

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

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

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

Limit

要指定读取操作返回的最大文档数，请创建一个用于设置limit选项的大量，并将该大量作为参数传递给MongoDB\Collection::find()方法。

以下示例查找cuisine字段值为'Italian'的所有餐厅，并将结果限制为5文档：

$cursor = $collection->find(
    ['cuisine' => 'Italian'],
    ['limit' => 5],
);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

提示

前面的示例根据文档在数据库中的自然顺序返回查询匹配的前五个文档。 以下部分介绍如何按指定顺序返回文档。

Sort

要按指定顺序返回文档，请创建一个设置sort选项的大量。 设置此选项时，请包括对结果进行排序的字段和排序方向。 值为1时，按从低到高的顺序排序；值为-1时，按从高到低的顺序排序。 然后，将该大量作为参数传递给MongoDB\Collection::find()或MongoDB\Collection::findOne()方法。

以下示例返回cuisine值为'Italian'的所有文档，并按name字段值的升序排序：

$cursor = $collection->find(
    ['cuisine' => 'Italian'],
    ['sort' => ['name' => 1]],
);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

跳过

要在返回查询结果之前跳过指定数量的文档，请创建一个设置skip选项的大量，并将该大量作为参数传递给MongoDB\Collection::find()或MongoDB\Collection::findOne()方法。

以下示例返回borough字段值为'Manhattan'的所有文档并跳过前10文档：

$cursor = $collection->find(
    ['borough' => 'Manhattan'],
    ['skip' => 10],
);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

组合限制、排序和跳过

您可以在单个选项大量中设立limit 、 sort和skip选项，并将该大量作为参数传递给读取操作。 这允许您设立要返回的最大排序文档数，在返回之前跳过指定数量的文档。

5以下示例返回cuisine 值为'Italian' 的 文档。结果按name字段值升序排序，并跳过前10文档：

$options = [
    'sort' => ['name' => 1],
    'limit' => 5,
    'skip' => 10,
];
$cursor = $collection->find(['cuisine' => 'Italian'], $options);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

注意

调用这些方法的顺序不会更改返回的文档。 MongoDB PHP库会自动对调用重新排序，以首先执行排序操作，然后执行跳过操作，然后执行限制操作。

指定返回类型

要自定义读取操作返回的文档的数据类型，可以在大量参数中传递typeMap选项。

默认，对MongoDB\Client 、 MongoDB\Database或MongoDB\Collection实例调用的方法使用以下类型映射：

[
    'array' => 'MongoDB\Model\BSONArray',
    'document' => 'MongoDB\Model\BSONDocument',
    'root' => 'MongoDB\Model\BSONDocument',
]

此默认类型映射执行以下转换：

  • 数组到MongoDB\Model\BSONArray对象

  • 顶级和嵌入式BSON文档到MongoDB\Model\BSONDocument对象

在自定义类型映射中，您可以指定转换为实现MongoDB\BSON\Unserializable的任何类型，以及array 、 stdClass和object类型。

例子

以下示例返回cuisine值为'Hawaiian'的所有文档，并指定typeMap选项以将文档转换为大量值：

$options = [
    'typeMap' => [
        'root' => 'array',
        'document' => 'array',
    ],
];
$cursor = $collection->find(['cuisine' => 'Hawaiian'], $options);
foreach ($cursor as $doc) {
    print_r($doc) . PHP_EOL;
}

更多信息

有关检索文档的更多信息，请参阅检索数据指南。

有关指定查询的更多信息，请参阅“指定查询”指南。

API 文档

要进一步了解本指南所讨论的任何方法或类型，请参阅以下 API 文档：

后退
查找文档
来年
指定要返回的字段
给本页内容打分

在此页面上