chapdel / laravel-meilitools
Additional tools for Laravel Scout integration with MeiliSearch
Requires
- php: ^7.4|^8.0|^8.1|^8.2
- illuminate/validation: ^8.0|^9.0|^10.0
Suggests
- brick/varexporter: Improves readability of console output for index details
README
The purpose of this package is to ease the configuration of indexes for MeiliSearch, so it's possible to use advanced filtering and sorting through Laravel Scout, without having to meddle with their API manually.
Table of Contents
Compatibility
Installation
Install this package via Composer:
$ composer require chapdel/laravel-meilitools
Configuration
Publish config using Artisan command:
$ php artisan vendor:publish --provider="Dwarf\MeiliTools\MeiliToolsServiceProvider"
Change configuration through config/meilitools.php
.
Usage
This package provides commands and helpers to ease the use of configuring MeiliSearch indexes.
Model Settings
Setup index settings for a model by implementing the method provided by the contract.
use Dwarf\MeiliTools\Contracts\Indexes\MeiliSettings; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\SoftDeletes; use Laravel\Scout\Searchable; class Article extends Model implements MeiliSettings { use Searchable; use SoftDeletes; /** * {@inheritdoc} */ public function meiliSettings(): array { // When using soft deletes '__soft_deleted' will automatically be added to filterable attributes. return ['filterableAttributes' => ['status']]; } }
A full list of available index settings can be found here.
Commands
The following commands are available:
meili:index:create
- Create a new MeiliSearch index
Arguments:
index
: Index name
Options:
--force
: Force the operation to run
meili:index:delete
- Delete a MeiliSearch index
Arguments:
index
: Index name
meili:index:details
- Get details for a MeiliSearch index
Arguments:
index
: Index name
meili:index:reset
- Reset settings for a MeiliSearch index
Arguments:
index
: Index name
Options:
--pretend
: Only shows what changes would have been done to the index
meili:index:view
- Get base information about a MeiliSearch index
Arguments:
index
: Index name
Options:
--stats
: Whether to include index stats
meili:indexes:list
- List all MeiliSearch indexes
Options:
--stats
: Whether to include index stats
meili:model:details
- Get details for a MeiliSearch model index
Arguments:
model
: Model class
meili:model:reset
- Reset settings for a MeiliSearch model index
Arguments:
model
: Model class
Options:
--pretend
: Only shows what changes would have been done to the index
meili:model:synchronize
- Synchronize settings for a MeiliSearch model index
Arguments:
model
: Model class
meili:model:view
- Get base information about a MeiliSearch model index
Arguments:
model
: Model class
Options:
--stats
: Whether to include index stats
Options:
--pretend
: Only shows what changes would have been done to the index
meili:models:synchronize
- Synchronize all models implementing MeiliSearch index settings
Options:
--pretend
: Only shows what changes would have been done to the indexes--force
: Force the operation to run when in production
Examples
Model commands can take both full class name and base name, with the latter being completed using the configured paths.
$ php artisan meili:model:details App\\Models\\Article
$ php artisan meili:model:details Article
$ php artisan meili:model:reset App\\Models\\Article
$ php artisan meili:model:reset Article
$ php artisan meili:model:synchronize App\\Models\\Article
$ php artisan meili:model:synchronize Article
$ php artisan meili:model:view App\\Models\\Article
$ php artisan meili:model:view Article
Testing
Running tests can be done either through composer, or directly calling the PHPUnit binary.
$ composer test
To run tests with code coverage, please make sure that phpdbg
exists and is executable.
$ composer test:coverage $ open tests/_reports/index.html
Career
Dwarf A/S is a digital agency based in Copenhagen (Denmark) and established January 1st 2000.
We're always looking for new talent, so have a look at our website for job openings.
License
The MIT License (MIT). Please see License File for more information.