Laravel Scout Algolia Search Example

Preview:

Step 1: Install Laravel Application

In this step, if you haven’t laravel application setup then we have to get fresh laravel application. So run bellow command and get clean fresh laravel application.

composer create-project --prefer-dist laravel/laravel blog

Step 2: Install Packages

In this step we have to add two packages, there are listed bellow:

1)laravel/scout

2)algolia/algoliasearch-client-php

Ok, so first we will install “laravel/scout” package by following command:

composer require laravel/scout

Now we have to publish configure file by using bellow command, After this command run, you will find new file scout.php in config folder and we will set configure details on it, so let’s run bellow command:

php artisan vendor:publish --provider="LaravelScoutScoutServiceProvider"

Now we need to set configuration queue is true in your env file:

.env

SCOUT_QUEUE=true

Ok, now we have to install package for “algolia”, so let’s run bellow command:

composer require algolia/algoliasearch-client-php

Step 3: Package Configuration

Ok, now we have to set id and secret of algolia, so first you have to create new account in algolia.com. So if you haven’t account on algolia.com site then click here and create new account : algolia.com.

Ok, after login we have to get application id and secret so click here and open that web page: GET APP ID and SECRET. After open you will see bellow screen and copy your id and secret.

Ok, now open your .env file and paste id and secret like as bellow:

.env

ALGOLIA_APP_ID=paste app id
ALGOLIA_SECRET=paste app secret

Step 4: Create Item Table and Model

In this step we have to create migration for items table using Laravel php artisan command, so first fire bellow command:

php artisan make:migration create_items_table

After this command you will find one file in following path database/migrations and you have to put bellow code in your migration file for create items table.

use IlluminateSupportFacadesSchema;
use IlluminateDatabaseSchemaBlueprint;
use IlluminateDatabaseMigrationsMigration;

class CreateItemsTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('items', function (Blueprint $table) {
           $table->increments('id');
           $table->string('title');
           $table->timestamps();
       });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::drop("items");
    }
}

After create “items” table you should create Item model for items, so first create file in this path app/Item.php and put bellow content in item.php file:

app/Item.php

<?php

namespace App;

use IlluminateDatabaseEloquentModel;
use LaravelScoutSearchable;

class Item extends Model
{

    use Searchable;

    public $fillable = ['title'];

    /**
     * Get the index name for the model.
     *
     * @return string
    */
    public function searchableAs()
    {
        return 'items_index';
    }
}

Step 5: Add New Route

In this is step we need to create routes for add new items and listing. so open your routes/web.php file and add following route.

routes/web.php

Route::get('items-lists', 'ItemSearchController@index')->name('items-lists');
Route::post('create-item', 'ItemSearchController@create')->name('create-item');

Step 6: Create Controller

In this step, now we should create new controller as ItemSearchController in this path app/Http/Controllers/ItemSearchController.php. this controller will manage all listing items and add new item request and return response, so put bellow content in controller file:

app/Http/Controllers/ItemSearchController.php

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppHttpRequests;
use AppItem;

class ItemSearchController extends Controller
{

	/**
     * Get the index name for the model.
     *
     * @return string
    */
    public function index(Request $request)
    {
        if($request->has('titlesearch')){
            $items = Item::search($request->titlesearch)
                ->paginate(6);
        }else{
            $items = Item::paginate(6);
        }
        return view('item-search',compact('items'));
    }

    /**
     * Get the index name for the model.
     *
     * @return string
    */
    public function create(Request $request)
    {
        $this->validate($request,['title'=>'required']);

        $items = Item::create($request->all());
        return back();
    }
}

Step 7: Create View

In Last step, let’s create item-search.blade.php(resources/views/item-search.blade.php) for layout and we will write design code here and put following code:

resources/views/item-search.blade.php

<!DOCTYPE html>
<html>
<head>
    <title>Laravel - laravel scout algolia search example</title>
    <link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css">
</head>
<body>

<div >
    <h2>Laravel Full Text Search using Scout and algolia</h2><br/>

    <form method="POST" action="{{ route('create-item') }}" autocomplete="off">
        @if(count($errors))
            <div >
                <strong>Whoops!</strong> There were some problems with your input.
                <br/>
                <ul>
                    @foreach($errors->all() as $error)
                    <li>{{ $error }}</li>
                    @endforeach
                </ul>
            </div>
        @endif

        <input type="hidden" name="_token" value="{{ csrf_token() }}">

        <div >
            <div >
                <div >
                    <input type="text" id="title" name="title"  placeholder="Enter Title" value="{{ old('title') }}">
                    <span >{{ $errors->first('title') }}</span>
                </div>
            </div>
            <div >
                <div >
                    <button >Create New Item</button>
                </div>
            </div>
        </div>
    </form>

    <div >
      <div >Item management</div>
      <div >
            <form method="GET" action="{{ route('items-lists') }}">

                <div >
                    <div >
                        <div >
                            <input type="text" name="titlesearch"  placeholder="Enter Title For Search" value="{{ old('titlesearch') }}">
                        </div>
                    </div>
                    <div >
                        <div >
                            <button >Search</button>
                        </div>
                    </div>
                </div>
            </form>

            <table >
                <thead>
                    <th>Id</th>
                    <th>Title</th>
                    <th>Creation Date</th>
                    <th>Updated Date</th>
                </thead>
                <tbody>
                    @if($items->count())
                        @foreach($items as $key => $item)
                            <tr>
                                <td>{{ ++$key }}</td>
                                <td>{{ $item->title }}</td>
                                <td>{{ $item->created_at }}</td>
                                <td>{{ $item->updated_at }}</td>
                            </tr>
                        @endforeach
                    @else
                        <tr>
                            <td colspan="4">There are no data.</td>
                        </tr>
                    @endif
                </tbody>
            </table>
            {{ $items->links() }}
      </div>
    </div>

</div>

</body>
</html>

Ok, now we are ready to run this example so quick run by following command:

php artisan serve

Now open your browser and run bellow link:

http://localhost:8000/items-lists

If you have already added few records on your table then you can index that records by run following command:

php artisan scout:import "AppItem"

Maybe it can help you…..