指定要返回的字段

样本数据

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

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

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

指定要包含的字段

要指定结果中包含的字段，请将选项大量传递给设置projection选项的MongoDB\Collection::findOne()或MongoDB\Collection::find()方法。使用以下语法设立此选项：

$options = [
    'projection' => [
        '<field name>' => 1,
    ],
];

以下示例创建一个选项大量并将projection选项设置为仅返回匹配文档的name 、 cuisine和borough字段。然后，它调用find()方法查找name字段值为'Emerald Pub'的所有餐厅，并将选项大量作为参数传递给find() ：

$options = [
    'projection' => [
        'name' => 1,
        'cuisine' => 1,
        'borough' => 1,
    ],
];
$cursor = $collection->find(['name' => 'Emerald Pub'], $options);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

当您使用投影指定要包含在返回文档中的字段时，默认情况下还会包含_id字段。 所有其他字段均会隐式排除。 要从返回文档中删除_id字段，您必须明确将其排除。

排除_id 字段

在指定要包含的字段时，您还可以从返回的文档中排除_id字段。

以下示例执行与上一示例相同的查询，但从投影中排除_id字段：

$options = [
    'projection' => [
        '_id' => 0,
        'name' => 1,
        'cuisine' => 1,
        'borough' => 1,
    ],
];
$cursor = $collection->find(['name' => 'Emerald Pub'], $options);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

指定要排除的字段

要指定要从结果中排除的字段，请将选项大量传递给设置projection选项的MongoDB\Collection::findOne()或MongoDB\Collection::find()方法。使用以下语法设立此选项：

$options = [
    'projection' => [
        '<field name>' => 0,
    ],
];

以下示例创建一个选项大量并设置projection选项以排除匹配文档的grades和address字段。然后，它调用find()方法查找name字段值为'Emerald Pub'的所有餐厅，并将选项大量作为参数传递给find() ：

$options = [
    'projection' => [
        'grades' => 0,
        'address' => 0,
    ],
];
$cursor = $collection->find(['name' => 'Emerald Pub'], $options);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

当您使用投影指定要排除的字段时，任何未指定的字段都将隐式包含在返回文档中。

API 文档

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

• MongoDB\Collection::findOne()

• MongoDB\Collection::find()