Lacasera Elastic Bridge

#An Eloquent Way To Search.

ElasticBridge allows you to write Fluent, Eloquent like queries against Elasticsearch and OpenSearch in your Laravel application.

With ElasticBridge, you can interact with your search indexes as easily as you would with traditional Eloquent models — full-text search, filters, aggregations, attribute casting, bulk indexing, and multi-index queries — bringing the power of Elasticsearch/OpenSearch into the Laravel ecosystem with no effort.

#Requirements

• PHP 8.2 or 8.3
• Laravel 10.x, 11.x, or 12.x
• Elasticsearch 8.x or OpenSearch 2.x

#Compatibility Matrix

#Installation

Install the package via Composer:

composer require lacasera/elastic-bridge

#Overview

php artisan make:bridge HotelRoom

<?php
declare(strict_types=1);
 
namespace App\Bridges;
 
use Lacasera\ElasticBridge\ElasticBridge;
 
class HotelRoom extends ElasticBridge
{
 
}

<?php
declare(strict_types=1);
 
namespace App\Http\Controllers;
 
use App\Bridges\HotelRoom;
use App\Requests\SearhRequest;
 
class SearchController extends  Controller
{
    public function __invoke(SearhRequest $request)
    {
        $rooms = HotelRoom::asBoolean()
            ->matchAll()
            ->orderBy('price', 'DESC'),
            ->filterByTerm('code', 'usd')
            ->filterByRange('price', 20, 'gte')
            ->filterByRange('price', 500, 'lte')
            ->cursorPaginate(50)
            ->get(['price']);
 
 
        return response()->json([
            'data' => $rooms
        ]);
    }
}

#Documentation

#AI-assisted development

ElasticBridge is built to be first-class for AI coding agents:

• Laravel Boost skill & guidelines. The package ships an elastic-bridge-development skill and core guidelines. If your project uses Laravel Boost, run php artisan boost:install and your agent automatically gets ElasticBridge-specific guidance.
• LLM-friendly docs. The documentation is published in the llms.txt format at elasticbridge.dev/llms.txt (index) and elasticbridge.dev/llms-full.txt (full text) so LLMs can read the whole API in one fetch.

composer test

#Changelog

Please see CHANGELOG for more information on what has changed recently.

#Contributing

Please see CONTRIBUTING for details.

#Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

#Credits

• Agyenim Boateng
• All Contributors

#License

The MIT License (MIT). Please see License File for more information.

TODO [] Add logging for queries and response...