Download the PHP package romanstruk/manticore-scout-engine without Composer

Manticore Scout Engine

Manticore Engine for Laravel Scout

Installation

Via Composer

Configuration

After installing Manticore Scout Engine, you should publish the Manticore configuration file using the vendor:publish Artisan command. This command will publish the manticore.php configuration file to your application's config directory:

Configuring Search Driver

Set up your search driver manticore in .env file

There is a choice between two ways to connect to the manticore

• http-client - \Manticoresearch\Client github
• mysql-builder - \RomanStruk\ManticoreScoutEngine\Builder use mysql connection

Set up your engine in .env file

Configuring Driver Connection

For http-client in .env file

For mysql-builder in .env file

Configuring Model Migration

To create a migration, specify the required fields in the searchable model

Configuring query options

max_matches - Maximum amount of matches that the server keeps in RAM for each index and can return to the client. Default is 1000.

For queries with pagination, you can specify automatic parameter calculation max_matches Set up your paginate_max_matches in manticore.php config file

Set null for calculate offset + limit

As some characters are used as operators in the query string, they should be escaped to avoid query errors or unwanted matching conditions. Set up your auto_escape_search_phrase in manticore.php config file

Set false for disable auto escape special symbols ! " $ ' ( ) - / < @ \ ^ | ~

Other parameters for queries can be specified in the model

Config paginate_max_matches has higher priority than scoutMetadata max_matches option

Usage

Documentation for Scout can be found on the Laravel website.

Run artisan command for create Manticore index

Manticore allows you to add "whereRaw" methods to your search queries.

Quorum matching operator

Quorum matching operator introduces a kind of fuzzy matching. It will only match those documents that pass a given threshold of given words. The example above ("the world is a wonderful place"/3) will match all documents that have at least 3 of the 6 specified words.

Proximity distance is specified in words, adjusted for word count, and applies to all words within quotes. For instance, "cat dog mouse"~5 query means that there must be less than 8-word span which contains all 3 words, ie.

Autocomplete

Autocomplete (or word completion) is a feature in which an application predicts the rest of a word a user is typing. On websites, it's used in search boxes, where a user starts to type a word, and a dropdown with suggestions pops up so the user can select the ending from the list.

Spell correction

Highlighting

Highlighting enables you to obtain highlighted text fragments (referred to as snippets) from documents containing matching keywords.

or

Percolate Query

To create a migration, specify the required fields in the searchable model

Percolate queries are also known as Persistent queries, Prospective search, document routing, search in reverse, and inverse search. https://manual.manticoresearch.com/Searching/Percolate_query#Percolate-Query

KNN

K-nearest neighbor vector search https://manual.manticoresearch.com/Searching/KNN#K-nearest-neighbor-vector-search

Added the ability to create records with the float_vector field type

Currently, the implementation is only available using whereRaw.

Please note that when using the "Find similar docs by id" syntax, you need to discard meta discardMeta(). Exact information about the number of results is not available

Change log

Please see the changelog for more information on what has changed recently.

Testing

Contributing

Please see contributing.md for details and a todolist.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

License

MIT. Please see the license file for more information.