安裝Laravel Scout 並發(fā)布配置文件；2. 通過Docker 或二進製文件安裝並運行Meilisearch；3. 在.env 中配置Meilisearch 驅(qū)動和主機地址；4. 在模型中添加Searchable trait 並定義toSearchableArray 方法；5. 使用scout:import 命令導(dǎo)入現(xiàn)有數(shù)據(jù)並啟用隊列自動同步；6. 使用Post::search() 進行搜索，支持分頁和限制結(jié)果數(shù)量；7. 通過where 方法實現(xiàn)過濾搜索，並通過API 設(shè)置索引屬性；8. 確保隊列worker 運行以保持索引實時更新，必要時可手動刷新和重新導(dǎo)入數(shù)據(jù)；最終實現(xiàn)快速、相關(guā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實施全文搜索？的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！