Download the PHP package wonsulting/opensearch-scout-driver-plus without Composer
On this page you can find all versions of the php package wonsulting/opensearch-scout-driver-plus. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wonsulting/opensearch-scout-driver-plus
More information about wonsulting/opensearch-scout-driver-plus
Files in wonsulting/opensearch-scout-driver-plus
Package opensearch-scout-driver-plus
Short Description Extension for OpenSearch Scout Driver
License MIT
Informations about the package opensearch-scout-driver-plus
OpenSearch Scout Driver Plus
Extension for OpenSearch Scout Driver.
Contents
- Features
- Compatibility
- Installation
- Usage
- Query
- Search parameters
- Search results
- Custom routing
- Eager loading relations
- Multiple connections
Features
OpenSearch Scout Driver Plus supports:
- Aggregations
- Custom routing
- Highlighting
- Multiple connections
- Search across multiple indices
- Source filtering
- Suggesters
Compatibility
The current version of OpenSearch Scout Driver Plus has been tested with the following configuration:
- PHP 8.2+
- OpenSearch 2.x
- Laravel 11.x-13.x
- Laravel Scout 10.x-11.x
Installation
The library can be installed via Composer:
Note that this library doesn't work without OpenSearch Scout Driver. If it's not installed yet, please follow the installation steps described here. If you already use OpenSearch Scout Driver, I recommend you to update it before installing OpenSearch Scout Driver Plus:
After installing the libraries, you need to add OpenSearch\ScoutDriverPlus\Searchable trait to your models. In case
some models already use the standard Laravel\Scout\Searchable trait, you should replace it with the one provided by
OpenSearch Scout Driver Plus.
Usage
Query
Before you begin searching a model, you should define a query. You can either use a query builder or describe the query with an array:
Each method of OpenSearch\ScoutDriverPlus\Support\Query factory creates a query builder for the respective type.
Available methods are listed below:
- bool
- exists
- fuzzy
- geoDistance
- ids
- matchAll
- matchNone
- matchPhrasePrefix
- matchPhrase
- match
- multiMatch
- nested
- prefix
- range
- regexp
- term
- terms
- wildcard
Search Parameters
When the query is defined, you can begin new search with searchQuery method:
You can then chain other parameters to make your search request more precise:
The builder supports various search parameters and provides a number of useful helpers:
- aggregate
- collapse
- from
- highlight
- join
- load
- minScore
- postFilter
- size
- sort
- refineModels
- rescore
- refineModels
- source
- suggest
- trackScores
- trackTotalHits
- when
- explain
Search Results
You can retrieve search results by chaining the execute method onto the builder:
$searchResult provides easy access to matching hits, models, documents, etc.:
You can get more familiar with the $searchResult object and learn how to paginate the search results on this page.
Custom Routing
If you want to use a custom shard routing
for your model, override the searchableRouting method:
Custom routing is automatically applied to all index and delete operations.
Eager Loading Relations
Sometimes you need to index your model with related data:
You can improve the performance of bulk operations by overriding the searchableWith method:
In case you are looking for a way to preload relations for models matching a search query, check the builder's
load method documentation.
Multiple Connections
You can configure multiple connections to OpenSearch in the client's configuration file.
If you want to change a connection used by a model, you need to override the searchableConnection method: