安裝 Laravel Scout 和 Algolia 客戶端；2. 在 .env 文件中配置 Algolia 憑據(jù)；3. 為模型添加 Searchable 特性并定義 toSearchableArray 方法；4. 使用 scout:import 命令導(dǎo)入現(xiàn)有數(shù)據(jù)；5. 通過 Post::search() 執(zhí)行搜索并支持分頁；6. 配置隊(duì)列以確保數(shù)據(jù)自動(dòng)同步；7. 可選使用 Algolia SDK 實(shí)現(xiàn)過濾、分面等高級功能；8. 自定義索引名稱通過 searchableAs 方法；9. 調(diào)用 delete 或 unsearchable 方法從 Algolia 刪除記錄，最終通過 scout:flush 清空整個(gè)索引，整個(gè)過程實(shí)現(xiàn)了高效、實(shí)時(shí)的搜索功能集成，且必須確保隊(duì)列服務(wù)正常運(yùn)行以保障同步性能，操作完整且不可中斷。

Using Algolia with Laravel Scout is a powerful way to add fast, scalable search functionality to your Laravel application. Here's how to set it up and use it effectively.

1. Install Laravel Scout and Algolia

First, install Laravel Scout via Composer:

composer require laravel/scout

Then, publish Scout’s configuration file:

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

This creates config/scout.php.

Next, install the Algolia client:

composer require algolia/algoliasearch-client-php

2. Configure Environment Variables

Add your Algolia credentials to your .env file. You can get these from your Algolia dashboard:

SCOUT_DRIVER=algolia
ALGOLIA_APP_ID=your_app_id
ALGOLIA_SECRET_KEY=your_admin_api_key

?? Never expose your ALGOLIA_SECRET_KEY in frontend code. This should only be used on the server side.

3. Make a Model Searchable

Choose the Eloquent model you want to make searchable (e.g., App\Models\Post) and implement the Searchable trait:

<?php

namespace App\Models;

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

class Post extends Model
{
    use Searchable;

    // Define the data to be indexed
    public function toSearchableArray()
    {
        $array = $this->toArray();

        // Customize what data is sent to Algolia
        return [
            'id' => $this->id,
            'title' => $this->title,
            'content' => $this->content,
            'author_name' => $this->user->name ?? null,
        ];
    }
}

Only the fields returned in toSearchableArray() will be available for searching and filtering in Algolia.

4. Import Existing Data

After setting up the model, sync your existing records to Algolia:

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

If you're using a different namespace or model name, adjust the path accordingly.

5. Perform Searches

Now you can search through your model using Scout:

use App\Models\Post;

$posts = Post::search(' Laravel ')->get();

You can also paginate results:

$posts = Post::search('Laravel')->paginate(15);

In your Blade view, render pagination links normally:

{{ $posts->links() }}

6. Keep Records Synced

Scout automatically listens to Eloquent events (created, updated, deleted) and keeps Algolia in sync if queueing is set up.

? Make sure your Laravel queue is configured (e.g., using Redis, database, or Horizon). Otherwise, syncing happens synchronously and may slow down requests.

Set your queue connection in .env:

QUEUE_CONNECTION=redis

7. Advanced Search Features (Using Algolia Directly)

For more advanced features like filtering, faceting, or typo tolerance, you can use Algolia’s SDK directly:

$client = new \Algolia\AlgoliaSearch\SearchClient::create(
    env('ALGOLIA_APP_ID'),
    env('ALGOLIA_SECRET_KEY')
);

$index = $client->initIndex('posts');

$results = $index->search('Laravel', [
    'filters' => 'author_name:John',
    'hitsPerPage' => 20,
]);

This gives you full access to Algolia’s powerful API.

8. Optional: Customize Index Name

By default, Scout uses the model’s plural name as the index. To customize it:

public function searchableAs()
{
    return 'custom_posts_index';
}

9. Remove Records from Algolia

To delete a record from the index:

$post->delete(); // Automatically removed via Scout

Or manually unindex:

$post->unsearchable();

To flush all records:

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

That’s it! With Scout and Algolia, you get real-time, typo-tolerant, fast search with minimal effort. Just make sure your queue driver is running so updates are synced smoothly.

Basically: set up Scout, configure Algolia, import data, and start searching — it’s that simple once the pieces are in place.

以上是如何將Algolia與Laravel Scout一起使用？的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！