Getting Started

An Elasticsearch implementation of Laravel’s Eloquent ORM

This package extends Laravel’s Eloquent model and query builder with seamless integration of Elasticsearch functionalities. Designed to feel native to Laravel, this package enables you to work with Eloquent models while leveraging the powerful search and analytics capabilities of Elasticsearch.

Looking to use the OpenSearch version of this package? Github

---

Installation - 4.x

• Laravel 11 and 10
• Elasticsearch 8.x
• Main branch (tag 4.x)

composer require pdphilip/elasticsearch

---

Configuration

1. Set up your .env with the following Elasticsearch settings:

   ES_AUTH_TYPE=http
   ES_HOSTS="http://localhost:9200"
   ES_USERNAME=
   ES_PASSWORD=
   ES_CLOUD_ID=
   ES_API_ID=
   ES_API_KEY=
   ES_SSL_CA=
   ES_INDEX_PREFIX=my_app
   # prefix will be added to all indexes created by the package with an underscore
   # ex: my_app_user_logs for UserLog.php model
   ES_SSL_CERT=
   ES_SSL_CERT_PASSWORD=
   ES_SSL_KEY=
   ES_SSL_KEY_PASSWORD=
   # Options
   ES_OPT_ID_SORTABLE=false
   ES_OPT_VERIFY_SSL=true
   ES_OPT_RETRIES=
   ES_OPT_META_HEADERS=true
   ES_ERROR_INDEX=

   For multiple nodes, pass in as comma-separated:

   ES_HOSTS="http://es01:9200,http://es02:9200,http://es03:9200"

   Example cloud config .env: (Click to expand)

   ES_AUTH_TYPE=cloud
   ES_HOSTS="https://xxxxx-xxxxxx.es.europe-west1.gcp.cloud.es.io:9243"
   ES_USERNAME=elastic
   ES_PASSWORD=XXXXXXXXXXXXXXXXXXXX
   ES_CLOUD_ID=XXXXX:ZXVyb3BlLXdl.........SQwYzM1YzU5ODI5MTE0NjQ3YmEyNDZlYWUzOGNkN2Q1Yg==
   ES_API_ID=
   ES_API_KEY=
   ES_SSL_CA=
   ES_INDEX_PREFIX=my_app
   ES_ERROR_INDEX=

2. In config/database.php, add the elasticsearch connection:

   'elasticsearch' => [
       'driver' => 'elasticsearch',
       'auth_type' => env('ES_AUTH_TYPE', 'http'), //http or cloud
       'hosts' => explode(',', env('ES_HOSTS', 'http://localhost:9200')),
       'username' => env('ES_USERNAME', ''),
       'password' => env('ES_PASSWORD', ''),
       'cloud_id' => env('ES_CLOUD_ID', ''),
       'api_id' => env('ES_API_ID', ''),
       'api_key' => env('ES_API_KEY', ''),
       'ssl_cert' => env('ES_SSL_CA', ''),
       'ssl' => [
           'cert' => env('ES_SSL_CERT', ''),
           'cert_password' => env('ES_SSL_CERT_PASSWORD', ''),
           'key' => env('ES_SSL_KEY', ''),
           'key_password' => env('ES_SSL_KEY_PASSWORD', ''),
       ],
       'index_prefix' => env('ES_INDEX_PREFIX', false),
       'options' => [
           'bypass_map_validation' => env('ES_OPT_BYPASS_MAP_VALIDATION', false),
           'insert_chunk_size' => env('ES_OPT_INSERT_CHUNK_SIZE', 1000),
           'logging' => env('ES_OPT_LOGGING', false),
           'allow_id_sort' => env('ES_OPT_ID_SORTABLE', false),
           'ssl_verification' => env('ES_OPT_VERIFY_SSL', true),
           'retires' => env('ES_OPT_RETRIES', null),
           'meta_header' => env('ES_OPT_META_HEADERS', true),
       ],
       'error_log_index' => env('ES_ERROR_INDEX', false),
   ],

3. If packages are not autoloaded, add the service provider: For Laravel 10 and below:

   config/app.php

   'providers' => [
       ...
       ...
       PDPhilip\Elasticsearch\ElasticServiceProvider::class,
       ...

   For Laravel 11:

   bootstrap/providers.php

   <?php
   return [
       App\Providers\AppServiceProvider::class,
       PDPhilip\Elasticsearch\ElasticServiceProvider::class,
   ];

Now, you’re all set to use Elasticsearch with Laravel as if it were native to the framework.

Package versions

Elasticsearch 8.x

Laravel Version	Command	Maintenance
Laravel 10 & 11	composer require pdphilip/elasticsearch	✅ Active
Laravel 9	composer require pdphilip/elasticsearch:~3.9	🛠️ LTS
Laravel 8	composer require pdphilip/elasticsearch:~3.8	🛠️ LTS
Laravel 7.x	composer require pdphilip/elasticsearch:~2.7	❌ EOL
Laravel 6.x (5.8)	composer require pdphilip/elasticsearch:~2.6	❌ EOL

Elasticsearch 7.x

Laravel Version	Command	Maintenance
Laravel 9.x	composer require pdphilip/elasticsearch:~1.9	❌ EOL
Laravel 8.x	composer require pdphilip/elasticsearch:~1.8	❌ EOL
Laravel 7.x	composer require pdphilip/elasticsearch:~1.7	❌ EOL
Laravel 6.x (5.8)	composer require pdphilip/elasticsearch:~1.6	❌ EOL

---