安裝 Laravel Scout 并發(fā)布配置文件；2. 通過 Docker 或二進制文件安裝并運行 Meilisearch；3. 在 .env 中配置 Meilisearch 驅動和主機地址；4. 在模型中添加 Searchable trait 并定義 toSearchableArray 方法；5. 使用 scout:import 命令導入現(xiàn)有數(shù)據(jù)并啟用隊列自動同步；6. 使用 Post::search() 進行搜索，支持分頁和限制結果數(shù)量；7. 通過 where 方法實現(xiàn)過濾搜索，并通過 API 設置索引屬性；8. 確保隊列 worker 運行以保持索引實時更新，必要時可手動刷新和重新導入數(shù)據(jù)；最終實現(xiàn)快速、相關且可擴展的全文搜索功能。

Implementing full-text search in a Laravel application using Laravel Scout and Meilisearch is a powerful way to add fast, relevant search functionality to your models. Here's how to set it up step by step.

? 1. Install and Configure Laravel Scout

Laravel Scout provides a simple, driver-based solution for adding full-text search to Eloquent models.

composer require laravel/scout

After installation, publish the Scout configuration file:

php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"

This creates config/scout.php.

? 2. Install and Run Meilisearch

Meilisearch is a lightweight, open-source search engine with typo-tolerant and instant search capabilities.

Option A: Using Docker (Recommended)

docker run -d -p 7700:7700 -v ./meilisearch-data:/meili_data getmeili/meilisearch:latest

? For development, no API key is required by default. In production, set a master key:

docker run -d -p 7700:7700 -e MEILI_MASTER_KEY=your_master_key getmeili/meilisearch:latest

Option B: Download Binary

Download from http://ipnx.cn/link/d3481ae553dc4bb6b970b151fbc0ec59 and run:

./meilisearch --http-addr 127.0.0.1:7700

? 3. Configure Meilisearch Driver in Laravel

Update your .env file:

SCOUT_DRIVER=meilisearch
MEILISEARCH_HOST=http://127.0.0.1:7700
MEILISEARCH_KEY=master_key_here (optional if set)

Make sure the meilisearch driver is used in config/scout.php:

'driver' => env('SCOUT_DRIVER', 'meilisearch'),
'meilisearch' => [
    'host' => env('MEILISEARCH_HOST', 'http://localhost:7700'),
    'key' => env('MEILISEARCH_KEY', null),
    'index-settings' => [
        // Optional: customize per index
    ],
],

? Note: If you're using an API key, ensure it's consistent between Meilisearch startup and your .env.

? 4. Add Searchable Trait to Your Model

Let’s say you want to make App\Models\Post searchable.

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Laravel\Scout\Searchable;

class Post extends Model
{
    use Searchable;

    // Define what data should be indexed
    public function toSearchableArray()
    {
        return [
            'id' => $this->id,
            'title' => $this->title,
            'content' => $this->content,
            'author_name' => $this->user->name ?? null,
        ];
    }
}

? You can customize toSearchableArray() to include relationships or transformed data.

? 5. Import Existing Data into Meilisearch

After setting up, sync your existing records:

php artisan scout:import "App\Models\Post"

? This command pushes all Post records to Meilisearch.

You can also keep data in sync automatically by using queueing (recommended):

In config/scout.php:

'queue' => true,

Then make sure your Laravel queue is running (php artisan queue:work) so updates/deletes are synced asynchronously.

? 6. Perform Searches in Your Application

Now you can search like this:

use App\Models\Post;

$results = Post::search('How to use Laravel')->get();

Return specific columns:

Post::search('Laravel Scout')->take(10)->get();

With pagination (just like Eloquent):

Post::search('tutorial')->paginate(15);

? Meilisearch handles typo tolerance, ranking, and partial matching out of the box.

? 7. Advanced: Filtered or Scoped Search

Use Meilisearch filters via Scout’s where method:

Post::search('Laravel')
    ->where('published', true)
    ->where('category_id', 5)
    ->get();

?? These fields must be marked as filterable attributes in Meilisearch settings.

To configure Meilisearch index settings (like searchable or filterable attributes), you can use the Meilisearch API:

curl -X POST 'http://127.0.0.1:7700/indexes/posts/settings' \
-H 'Content-Type: application/json' \
--data-binary '{
  "searchableAttributes": ["title", "content"],
  "filterableAttributes": ["published", "category_id"]
}'

? 8. Keep Index Updated

Scout listens to Eloquent events. After setup:

• New posts are automatically added.
• Updated posts are synced.
• Deleted posts are removed.

Ensure your queue worker is running:

php artisan queue:work

Or manually sync:

php artisan scout:import "App\Models\Post"

To flush and reimport:

php artisan scout:flush "App\Models\Post"
php artisan scout:import "App\Models\Post"

Final Notes

• Meilisearch is fast, easy to deploy, and developer-friendly.
• Laravel Scout abstracts the complexity and integrates smoothly.
• Always use queues in production to avoid blocking HTTP requests during indexing.
• Secure your Meilisearch instance in production with API keys and HTTPS.

That’s it! You now have a fully functional full-text search using Laravel Scout and Meilisearch. Search queries will be fast, relevant, and scalable for most applications.

以上是如何使用Laravel Scout和Meilisearch實施全文搜索？的詳細內容。更多信息請關注PHP中文網(wǎng)其他相關文章！