读取操作

Overview

在本指南中，您可以查看常用方法的代码模板，您可以使用这些模板通过 Laravel MongoDB从MongoDB读取数据。

查找一个

以下代码演示如何从集合中检索第一个匹配的文档：

SampleModel::where('<field name>', '<value>')
    ->first();

要查看查找一个文档的可运行示例，请参阅“查找文档”用法示例。

要学习；了解有关检索文档和first() 方法的更多信息，请参阅《检索数据》指南。

查找多个

以下代码演示如何从集合中检索与查询过滤匹配的所有文档：

SampleModel::where('<field name>', '<value>')
    ->get();

要查看查找文档的可运行示例，请参阅查找多个文档用法示例。

如需了解有关检索文档的更多信息，请参阅“检索数据”指南。

返回所有文档

以下代码演示如何从集合中检索所有文档：

SampleModel::get();
// Or, use the all() method.
SampleModel::all();

要查看查找文档的可运行示例，请参阅查找多个文档用法示例。

如需了解有关检索文档的更多信息，请参阅“检索数据”指南。

搜索文本

以下代码演示如何对集合文档中的字符串字段执行全文搜索：

SampleModel::where('$text', ['$search' => '<search term or phrase>'])
    ->get();

要学习；了解有关搜索文本字段的更多信息，请参阅“搜索文本”指南。

计算文档

以下代码演示了如何计算集合中的文档：

SampleModel::count();
// You can also count documents that match a filter.
SampleModel::where('<field name>', '<value>')
    ->count();

要查看对文档进行计数的可运行示例，请参阅计数文档用法示例。

Retrieve Distinct Values

以下代码演示如何检索指定字段的非重复值：

SampleModel::select('<field name>')
    ->distinct()
    ->get();

要查看返回不同字段值的可运行示例，请参阅检索不同字段值用法示例。

跳过结果

以下代码演示如何跳过从MongoDB返回的指定数量的文档：

SampleModel::where('<field name>', '<value>')
    ->skip(<number to skip>)
    ->get();

要学习；了解有关修改 Laravel MongoDB返回结果方式的更多信息，请参阅 修改查询结果指南。

限制结果

以下代码展示了如何从MongoDB中仅返回指定数量的文档：

SampleModel::where('<field name>', '<value>')
    ->take(<number to return>)
    ->get();

要学习；了解有关修改 Laravel MongoDB返回结果方式的更多信息，请参阅 修改查询结果指南。

对结果进行排序

以下代码展示了如何对从MongoDB返回的结果设立排序顺序：

SampleModel::where('field name', '<value>')
    ->orderBy('<field to sort on>')
    ->get();

要学习；了解有关修改 Laravel MongoDB返回结果方式的更多信息，请参阅 修改查询结果指南。

设置读取偏好

以下代码展示了如何在执行查找操作时设立读取偏好（read preference）：

SampleModel::where('field name', '<value>')
    ->readPreference(ReadPreference::SECONDARY_PREFERRED)
    ->get();

要学习；了解有关读取偏好的更多信息，请参阅“设置读取偏好”指南。