laravel scout——迹忆客-ag捕鱼王app官网

配置搜索数据

默认情况下，模型以完整的 toarray 格式持久化到搜索索引，如果我们想要自定义被持久化到搜索索引的数据，可以重写模型上的 tosearchablearray 方法：

toarray();
        // customize array...
        return $array;
    }
}

配置模型 id

默认情况下，scout 会使用模型的主键作为唯一 id 将其存储到搜索索引中。如果你需要自定义这个行为，可以在模型类中重写 getscoutkey 和 getscoutkeyname 方法：

email;
    }
    /**
     * get the key name used to index the model.
     *
     * @return mixed
     */
    public function getscoutkeyname()
    {
        return 'email';
    }
}

识别用户

scout 还允许我们在使用 algolia 时自动识别用户。在 algolia 面板中查看我们的搜索分析时，将经过身份验证的用户与搜索操作相关联可能会有所帮助。可以通过在.env文件中设置scout_identify为true来启用用户标识：

scout_identify=true

索引

批量导入

如果将 scout 安装到了已存在的项目，可能该项目之前已经有了可以导入搜索驱动的数据库记录，scout 提供了 artisan 命令 import 用于导入所有已存在的数据到搜索索引：

$ php artisan scout:import "app\post"

flush 方法可用于从搜索索引中移除所有模型记录：

$ php artisan scout:flush "app\post"

添加记录

添加 laravel\scout\searchable trait 到模型之后，剩下需要做的就是保存模型实例，然后该实例会自动被添加到模型索引，如果我们配置了 scout 使用队列，该操作会被推送到队列在后台执行：

$order = new app\order;
// ...
$order->save();

通过查询添加

如果你想要通过 eloquent 查询添加模型集合到搜索索引，可以在 eloquent 查询之后追加 searchable 方法调用。searchable 方法会分组块进行查询并将结果添加到搜索索引。再次强调，如果你配置了 scout 使用队列，所有的组块查询会被推送到队列在后台进行：

// adding via eloquent query...
app\order::where('price', '>', 100)->searchable();
// you may also add records via relationships...
$user->orders()->searchable();
// you may also add records via collections...
$orders->searchable();

searchable 方法会进行“upsert”操作，换句话说，如果模型记录已经存在于索引，则会被更新，如果不存在，才会被添加。

更新记录

要更新支持搜索的模型，只需更新模型实例的属性并保存模型到数据库。scout 会自动持久化更新到搜索索引：

$order = app\order::find(1);
// update the order...
$order->save();

还可以使用模型查询提供的 searchable 方法更新模型集合，如果模型在搜索索引中不存在，则会被创建：

// updating via eloquent query...
app\order::where('price', '>', 100)->searchable();
// you may also update via relationships...
$user->orders()->searchable();
// you may also update via collections...
$orders->searchable();

删除记录

要从索引中删除记录，只需从数据库中删除对应记录即可，这种删除方式甚至兼容软删除模型：

$post = app\post::find(1);
$post->delete();

如果在删除记录前不想获取模型，可以使用模型查询实例或集合上的 unsearchable 方法：

// removing via eloquent query...
app\order::where('price', '>', 100)->unsearchable();
// you may also remove via relationships...
$user->orders()->unsearchable();
// you may also remove via collections...
$orders->unsearchable();

暂停索引

有时候我们需要在不同步模型数据到搜索索引的情况下执行批量的 eloquent 操作，可以通过 withoutsyncingtosearch 方法来实现。该方法接收一个立即被执行的回调，该回调中出现的所有模型操作都不会同步到搜索索引：

app\post::withoutsyncingtosearch(function () {
    // perform model actions...
});

带条件的搜索模型实例

有时候我们可能需要在特定条件下对模型进行搜索，例如，假设你有一个 app\post 模型，它有两种状态：“default”和 “published”，你可能只想对“published”状态的文章进行搜索，要实现这个功能，可以在模型类中定义一个 shouldbesearchable 方法：

public function shouldbesearchable()
{
    return $this->ispublished();
}

shouldbesearchable 只有在通过 save 方、查询和关联关系操作模型时才会应用。直接使用 searchable 方法让模型或集合变得可搜索将会覆盖 shouldbesearchable 方法的结果：

// will respect "shouldbesearchable"...
app\order::where('price', '>', 100)->searchable();
$user->orders()->searchable();
$order->save();
// will override "shouldbesearchable"...
$orders->searchable();
$order->searchable();

搜索

我们可以通过 search 方法来搜索一个模型，该方法接收一个用于搜索模型的字符串，然后我们还需要在这个搜索查询上调用一个 get 方法来获取与给定搜索查询相匹配的 eloquent 模型：

$posts = app\post::search('star trek')->get();

由于 scout 搜索返回的是 eloquent 模型集合，我们甚至可以直接从路由或控制器中返回结果，它们将会被自动转换为 json 格式：

use illuminate\http\request;
route::get('/search', function (request $request) {
    return app\post::search($request->search)->get();
});

如果我们想要获取原生搜索结果而不是转化后的 eloquent 模型，可以使用 raw 方法：

$posts = app\post::search('star trek')->raw();

搜索查询使用模型类的 searchas 方法指定的索引进行查询。不过，我们也可以使用 within 方法指定一个自定义的索引进行搜索：

$orders = app\order::search('star trek')
    ->within('tv_shows_popularity_desc')
    ->get();

where 子句

scout 允许我们添加简单的 where 子句到搜索查询，目前，这些子句仅支持简单的数值相等检查，由于搜索索引不是关系型数据库，更多高级的 where 子句暂不支持：

$orders = app\order::search('star trek')->where('user_id', 1)->get();

分页

除了获取模型集合之外，还可以使用 paginate 方法对搜索结果进行分页，该方法返回一个 paginator 实例 —— 就像你对传统 eloquent 查询进行分页一样：

$orders = app\order::search('star trek')->paginate();

可以通过传入数量作为 paginate 方法的第一个参数来指定每页显示多少个模型：

$orders = app\order::search('star trek')->paginate(15);

获取结果之后，可以使用 blade 显示结果并渲染分页链接，就像对传统 eloquent 查询进行分页时一样：

    @foreach ($orders as $order)
        {{ $order->price }}
    @endforeach

{{ $orders->links() }}

软删除

如果你的索引模型被软删除但是需要搜索软删除模型，可以设置配置文件 config/scout.php 的 soft_delete 选项为 true：

'soft_delete' => true,

该配置项被设置为 true 时，scout 将不会从搜索索引中移除软删除模型。取而代之地，将会在索引记录上设置一个隐藏的 __soft_deleted 属性。然后，你可以使用 withtrashed 或 onlytrashed 方法在搜索时获取软删除记录：

// include trashed records when retrieving results...
$orders = app\order::withtrashed()->search('star trek')->get();
// only include trashed records when retrieving results...
$orders = app\order::onlytrashed()->search('star trek')->get();

注：使用 forcedelete 永久删除软删除模型后，scout 会自动将其从搜索索引中移除。

自定义引擎搜索

如果我们需要自定义引擎的搜索行为可以传递一个回调到 search 方法作为第二个参数。例如，你可以在搜索查询被传递到 algolia 之前使用这个回调添加地理位置数据到搜索选项：

use algolia\algoliasearch\searchindex;
app\order::search('star trek', function (searchindex $algolia, string $query, array $options) {
    $options['body']['query']['bool']['filter']['geo_distance'] = [
        'distance' => '1000km',
        'location' => ['lat' => 36, 'lon' => 111],
    ];
    return $algolia->search($query, $options);
})->get();

自定义引擎

编写引擎

如果某个内置的 scout 搜索引擎不满足你的需求，可以编写自定义的引擎并将其注册到 scout，自定义的引擎需要继承自抽象类 laravel\scout\engines\engine，该抽象类包含了 7 个自定义引擎必须实现的方法：

use laravel\scout\builder;
abstract public function update($models);
abstract public function delete($models);
abstract public function search(builder $builder);
abstract public function paginate(builder $builder, $perpage, $page);
abstract public function mapids($results);
abstract public function map($results, $model);
abstract public function gettotalcount($results);
abstract public function flush($model);

这些方法的实现可以参考 laravel\scout\engines\algoliaengine 类，这个类为我们学习如何在自定义引擎中实现这些方法提供了最佳范本。

注册引擎

编写好自定义引擎之后，可以通过 scout 引擎管理器提供的 extend 方法将其注册到 scout。我们需要在 appserviceprovider（或者其他 service provider ）的 boot 方法中调用这个 extend 方法。例如，如果你编写了 mysqlsearchengine，可以这样注册：

use laravel\scout\enginemanager;
/**
 * bootstrap any application services.
 *
 * @return void
 */
public function boot()
{
    resolve(enginemanager::class)->extend('mysql', function () {
        return new mysqlsearchengine;
    });
}

引擎被注册之后，可以在配置文件 config/scout.php 中将其设置为 scout 默认的驱动：

'driver' => env('scout_driver', 'mysql'),

构建器宏

如果我们想要定义自定义的构建器方法，可以使用 laravel\scout\builder 提供的 macro 方法。通常，我们在服务提供者的 boot 方法中定义“宏”：

engine->gettotalcount(
                $this->engine()->search($this)
            );
        });
    }
}

macro 方法接收方法名作为第一个参数以及一个闭包函数作为第二个参数，宏的闭包函数会在 laravel\scout\builder 实现上调用宏方法时被执行：

app\order::search('star trek')->count();