ElasticSearch Driver for Laravel Scout


May 27th, 2021


Explorer is a next-gen Elasticsearch driver for Laravel Scout with the power of Elasticsearch’s queries. It provides a compatible Scout driver, as well as additional conveniences. For example, the Explored interface defines a mappableAs() method for getting configuration:

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use JeroenG\Explorer\Application\Explored;
use Laravel\Scout\Searchable;

class Post extends Model implements Explored
    use HasFactory;
    use Searchable;

    protected $fillable = ['title', 'published'];

    public function mappableAs(): array
        return [
            'id' => 'keyword',
            'title' => 'text',
            'published' => 'boolean',
            'created_at' => 'date',

Then in your explorer config you can reference the model under indexes like so:

return [
    'indexes' => [

Apart from the standard features you get out-of-the-box with Laravel Scout, Explorer provides a way to use query builders to write more complex queries. The advanced queries documentation has an example of using the query builder functionality with this package:

$posts = Post::search('lorem')
    ->must(new Matching('title', 'ipsum'))
    ->should(new Terms('tags', ['featured'], 2))
    ->filter(new Term('published', true))

The package also provides a few commands to manage indexes and search via the CLI:

# create indexes
php artisan elastic:create

# delete indexes
php artisan elastic:delete

# search indexes
php artisan elastic:search "App\Models\Post" lorem

Learn More

The Explorer documentation walks you through getting set up through more advanced settings and code. The source code is available on GitHub.

Also, check out Exploring Elasticsearch with Laravel Scout , which explains getting started with Elasticsearch locally via Docker and setting up Explorer and Laravel Scout.

The author of the package also has a demo application that might be helpful to explore how to integrate Explorer in your Laravel application.

Filed in:

Paul Redmond

Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.