读取操作

Overview

在本指南中，您可以了解如何使用 Laravel MongoDB 对 MongoDB collection执行查找操作。查找操作允许您根据指定的条件检索文档。

本指南介绍如何执行以下任务：

• 检索与查询匹配的文档

• 检索collection中的所有文档

• Atlas Search文本字段

• 修改查找操作行为

开始之前

要运行本指南中的代码示例，请完成快速入门教程。 本教程说明如何使用示例数据设置MongoDB Atlas实例，并在 Laravel Web应用程序中创建以下文件：

• Movie.php 文件，其中包含一个Movie movies模型来表示collection中的文档

• MovieController.php 文件，其中包含用于运行数据库操作的show()函数

• browse_movies.blade.php 文件，其中包含用于显示数据库操作结果的 HTML 代码

以下部分介绍如何编辑 Laravel 应用程序中的文件以运行查找操作代码示例并查看预期输出。

检索与查询匹配的文档

您可以使用 Laravel 的 Eloquent 对象关系映射器 (ORM) 来创建表示 MongoDB 集合的模型，并在模型上使用链式方法来指定查询条件。

要检索与一设立条件匹配的文档，请对该集合的相应 Eloquent 模型调用where()方法，然后向该方法传递查询过滤。

查询筛选器指定字段值要求，并指示查找操作仅返回满足这些要求的文档。

您可以使用以下where()方法调用之一来构建查询：

• where('<field name>', <value>) 构建一个查询，用于匹配目标字段具有确切指定值的文档

• where('<field name>', '<comparison operator>', <value>) 构建一个查询，用于匹配目标字段值满足比较条件的文档

要将多组条件应用于查找操作，可以将一系列where()方法链接在一起。

使用where()方法构建查询后，链接get()方法以检索查询结果。

此示例在Movie Eloquent 模型上调用两个where()方法来检索满足以下条件的文档：

• year 字段的值为 2010

• imdb.rating 嵌套字段的值大于 8.5

$movies = Movie::where('year', 2010)
    ->where('imdb.rating', '>', 8.5)
    ->get();

class MovieController
{
    public function show()
    {
         $movies = Movie::where('year', 2010)
             ->where('imdb.rating', '>', 8.5)
             ->get();
         return view('browse_movies', [
             'movies' => $movies
         ]);
    }
}

要了解如何使用 Laravel 查询构建器而不是 Eloquent ORM 进行查询，请参阅查询构建器页面。

$movies = Movie::where('countries', ['Indonesia', 'Canada'])
    ->get();

$movies = Movie::where('countries', 'in', ['Canada', 'Egypt'])
    ->get();

检索collection中的所有文档

您可以通过省略查询筛选器来检索collection中的所有文档。要返回文档，请在表示collection的 Eloquent 模型上调用get()方法。或者，您可以使用get()方法的别名all()来执行相同的操作。

使用以下语法运行匹配所有文档的查找操作：

$movies = Movie::get();

Atlas Search文本字段

文本Atlas Search会检索在文本索引字段中包含术语或短语的文档。 术语是不包括空白字符的字符序列。 短语是具有任意数量的空白字符的一系列术语。

您可以执行文本Atlas Search ，方法是使用$text操作符，然后使用查询筛选器中传递给 where() 方法的 $search 字段。 $text 操作符对文本索引字段执行文本Atlas Search 。 $search 字段指定要Atlas Search的文本。

使用where()方法构建查询后，链接get()方法以检索查询结果。

此示例在Movie Eloquent 模型上调用where()方法，以检索plot字段包含短语"love story"的文档。 要执行此文本Atlas Search ，集合必须在 plot 字段上具有文本索引。

$movies = Movie::where('$text', ['$search' => '"love story"'])
    ->get();

class MovieController
{
    public function show()
    {
         $movies = Movie::where('$text', ['$search' => '"love story"'])
             ->get();
         return view('browse_movies', [
             'movies' => $movies
         ]);
    }
}

文本Atlas Search会分配一个数字文本分数，以指示每个结果与查询筛选器中的string的匹配程度。 您可以使用orderBy()方法对textScore元数据字段进行排序，从而按相关性对结果进行排序。 您可以使用$meta操作符访问此元数据：

$movies = Movie::where('$text', ['$search' => '"love story"'])
    ->orderBy('score', ['$meta' => 'textScore'])
    ->get();

修改行为

您可以通过将更多方法链接到where()来修改查找操作的结果。

以下部分演示如何修改where()方法的行为：

• 跳过和限制结果使用skip()方法设置要跳过的文档数，使用take()方法设置要返回的文档总数

• 对查询结果进行排序使用orderBy()方法根据字段值按指定顺序返回查询结果

• 返回第一个结果使用first()方法返回与查询筛选器匹配的第一个文档

$movies = Movie::where('year', 1999)
    ->skip(2)
    ->take(3)
    ->get();

class MovieController
{
    public function show()
    {
         $movies = Movie::where('year', 1999)
             ->skip(2)
             ->take(3)
             ->get();
         return view('browse_movies', [
             'movies' => $movies
         ]);
    }
}

$movies = Movie::where('countries', 'Indonesia')
    ->orderBy('year')
    ->orderBy('title', 'desc')
    ->get();

class MovieController
{
    public function show()
    {
        $movies = Movie::where('countries', 'Indonesia')
            ->orderBy('year')
            ->orderBy('title', 'desc')
            ->get();
        return view('browse_movies', [
            'movies' => $movies
        ]);
    }
}

$movie = Movie::where('runtime', 30)
    ->orderBy('_id')
    ->first();

class MovieController
{
    public function show()
    {
        $movie = Movie::where('runtime', 30)
            ->orderBy('_id')
            ->first();
        return view('browse_movies', [
            'movies' => $movie
        ]);
    }
}