如何在Laravel中实现高性能全文本搜索？Typesense与Scout驱动助你一臂之力！

<code class="bash">composer require php-http/guzzle7-adapter</code>

<code class="bash">composer require laravel/scout</code>

<code class="bash">php artisan vendor:publish --provider="LaravelScoutScoutServiceProvider"</code>

<code class="dotenv">SCOUT_DRIVER=typesense</code>

<pre class="brush:php;toolbar:false;">// config/scout.php

return [
    // ... 其他配置

    'typesense' => [
        'api_key'         => env('TYPESENSE_API_KEY', 'your_typesense_api_key'), // 你的 Typesense API Key
        'nodes'           => [
            [
                'host'     => env('TYPESENSE_HOST', 'localhost'),
                'port'     => env('TYPESENSE_PORT', '8108'),
                'path'     => env('TYPESENSE_PATH', ''),
                'protocol' => env('TYPESENSE_PROTOCOL', 'http'),
            ],
        ],
        'nearest_node'    => [ // 可选，用于读操作的最近节点
            'host'     => env('TYPESENSE_NEAREST_HOST', 'localhost'),
            'port'     => env('TYPESENSE_NEAREST_PORT', '8108'),
            'path'     => env('TYPESENSE_NEAREST_PATH', ''),
            'protocol' => env('TYPESENSE_NEAREST_PROTOCOL', 'http'),
        ],
        'connection_timeout_seconds'   => 2,
        'healthcheck_interval_seconds' => 30,
        'num_retries'                  => 3,
        'retry_interval_seconds'       => 1,
    ],
];

<pre class="brush:php;toolbar:false;"><?php

namespace AppModels;

use IlluminateDatabaseEloquentModel;
use LaravelScoutSearchable;
use TypesenseLaravelTypesenseInterfacesTypesenseDocument; // 注意这个接口的引入

class Product extends Model implements TypesenseDocument
{
    use Searchable;

    /**
     * 获取模型的可搜索数据数组。
     *
     * @return array
     */
    public function toSearchableArray()
    {
        // 返回你希望 Typesense 索引的字段
        return array_merge(
            $this->toArray(),
            [
                'id' => (string) $this->id, // Typesense通常将ID视为字符串
                'created_at' => $this->created_at->timestamp, // 将日期转换为时间戳
            ]
        );
    }

    /**
     * Typesense Collection 的 Schema 定义。
     *
     * @return array
     */
    public function getCollectionSchema(): array
    {
        return [
            'name' => $this->searchableAs(), // Collection 名称，通常是模型的表名
            'fields' => [
                ['name' => 'id', 'type' => 'string'],
                ['name' => 'name', 'type' => 'string'],
                ['name' => 'description', 'type' => 'string'],
                ['name' => 'price', 'type' => 'float'],
                ['name' => 'created_at', 'type' => 'int64'],
            ],
            'default_sorting_field' => 'created_at', // 默认排序字段
        ];
    }

    /**
     * 定义 Typesense 搜索时要查询的字段。
     *
     * @return array
     */
    public function typesenseQueryBy(): array
    {
        return [
            'name',
            'description',
        ];
    }
}

<code class="bash">php artisan scout:import "App\Models\Product"</code>

<pre class="brush:php;toolbar:false;">use AppModelsProduct;

// 简单搜索
$results = Product::search('手机')->get();

// 带有过滤和排序的搜索
$filteredResults = Product::search('笔记本')
                        ->where('price', '<', 5000)
                        ->orderBy('created_at', 'desc')
                        ->paginate(10);

// 多重搜索 (Multi-Search)
// Typesense 驱动也支持 Laravel Scout 的 multi-search 功能
$searchRequests = [
    ['collection' => 'products', 'q' => '手机'],
    ['collection' => 'articles', 'q' => '编程'],
];
// 具体的实现方式可能需要查看 Typesense PHP SDK 或 Scout 扩展的文档
// 例如：Product::search('')->searchMulti($searchRequests)->paginateRaw();