Download the PHP package synergy/scout-elasticsearch-driver without Composer
On this page you can find all versions of the php package synergy/scout-elasticsearch-driver. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download synergy/scout-elasticsearch-driver
More information about synergy/scout-elasticsearch-driver
Files in synergy/scout-elasticsearch-driver
Package scout-elasticsearch-driver
Short Description The Elasticsearch Driver for Laravel Scout
License MIT
Homepage https://odiaseo.github.io/scout-elasticsearch-driver/
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package scout-elasticsearch-driver
Laravel Scout Elasticsearch Driver
This package offers advanced functionality for searching and filtering data in Elasticsearch. Check out its features!
Contents
- Tutorial
- Features
- Requirements
- Installation
- Configuration
- Index configurator
- Searchable model
- Usage
- Console commands
- Search rules
- Available filters
- Debug
Features
- An easy way to create an Elasticsearch index.
- A fully configurable mapping for each model.
- A possibility to add a new field to an existing mapping the artisan command.
- Lots of different ways to implement your search algorithm: using raw search.
- Various filter types to make a search query more specific.
Requirements
The package has been tested in the following configuration:
- PHP version >= 7.0
- Laravel Framework version >= 5.5
- Elasticsearch version >= 5.5
Installation
Use composer to install the package:
Configuration
To configure the package you need to publish settings first:
Then, set the driver setting to elastic in the config/scout.php file and configure the driver itself in the config/synergy-scout-elastic.php file.
There are two available options:
| Option | Description |
|---|---|
| client | A setting hash to build Elasticsearch client. More information you can find here. By default the host is set to localhost:9200. |
| update_mapping | The option that specifies whether to update a mapping automatically or not. By default it is set to true. |
Index configurator
An index configurator class is used to set up settings for an Elasticsearch index. To create a new index configurator use the following artisan command:
It'll create the file MyIndexConfigurator.php in the app folder of your project.
You can specify index name, settings and default mapping like in the following example:
More about index settings and default mapping you can find in the index management section of Elasticsearch documentation.
To create an index just run the artisan command:
Searchable model
To create a model with the ability to perform search requests in an Elasticsearch index use the command:
After executing the command you'll find the file MyModel.php in you app folder:
Each searchable model represents an Elasticsearch type.
By default a type name is the same as a table name, but you can set any type name you want through the searchableAs method.
You can also specify fields which will be indexed by the driver through the toSearchableArray method.
More information about these options you will find in the scout official documentation.
The last important option you can set in the MyModel class is the $searchRules property.
It allows you to set different search algorithms for a model.
We'll take a closer look at it in the search rules section.
After setting up a mapping in your model you can update an Elasticsearch type mapping:
Usage
Once you've created an index configurator, an Elasticsearch index itself and a searchable model, you are ready to go. Now you can index and search data according to the documentation.
In addition to standard functionality the package offers you the possibility to filter data in Elasticsearch without specifying query string:
Also you can override model search rules:
And use variety of where conditions:
At last, if you want to send a custom request, you can use the searchRaw method:
This query will return raw response.
Console commands
Available artisan commands are listed below:
| Command | Arguments | Description |
|---|---|---|
| make:index-configurator | name - The name of the class |
Creates a new Elasticsearch index configurator. |
| make:searchable-model | name - The name of the class |
Creates a new searchable model. |
| make:search-rule | name - The name of the class |
Creates a new search rule. |
| elastic:create-index | index-configurator - The index configurator class |
Creates an Elasticsearch index. |
| elastic:update-index | index-configurator - The index configurator class |
Updates settings and mappings of an Elasticsearch index. |
| elastic:drop-index | index-configurator - The index configurator class |
Drops an Elasticsearch index. |
| elastic:update-mapping | model - The model class |
Updates a model mapping. |
For detailed description and all available options run php artisan help [command] in the command line.
Search rules
A search rule is a class that describes how a search query will be executed. To create a search rule use the command:
In the file app/MySearchRule.php you will find a class definition:
You can read more about bool queries here.
The default search rule returns the following payload:
This means that by default when you call search method on a model it tries to find the query string in any field.
To determine default search rules for a model just add a property:
You can also set a search rule in a query builder:
Available filters
You can use different types of filters:
| Method | Example | Description |
|---|---|---|
| where($field, $value) | where('id', 1) | Checks equality to a simple value. |
| where($field, $operator, $value) | where('id', '>=', 1) | Filters records according to a given rule. Available operators are: =, <, >, <=, >=, <>. |
| whereIn($field, $value) | where('id', [1, 2, 3]) | Checks if a value is in a set of values. |
| whereNotIn($field, $value) | whereNotIn('id', [1, 2, 3]) | Checks if a value isn't in a set of values. |
| whereBetween($field, $value) | whereBetween('price', [100, 200]) | Checks if a value is in a range. |
| whereNotBetween($field, $value) | whereNotBetween('price', [100, 200]) | Checks if a value isn't in a range. |
| whereExists($field) | whereExists('unemployed') | Checks if a value is defined. |
| whereNotExists($field) | whereNotExists('unemployed') | Checks if a value isn't defined. |
| whereRegexp($field, $value, $flags = 'ALL') | whereRegexp('name.raw', 'A.+') | Filters records according to a given regular expression. Here you can find more about syntax. |
In most cases it's better to use raw fields to filter records, i.e. not analyzed fields.
Debug
There are two methods that can help you to analyze results of a search query:
Both methods return raw data from ES.
Besides, you can get a query payload that will be sent to ES, by calling the buildPayload method.
Note, that this method returns a collection of payloads, because of possibility of using multiple search rules in one query.
All versions of scout-elasticsearch-driver with dependencies
elasticsearch/elasticsearch Version ^7.14
doctrine/instantiator Version ^1.4
laravel/framework Version ^8.0
laravel/scout Version ^9.2