Weave Code
Meilisearch Laravel Scout Laravel Package
meilisearch/meilisearch-laravel-scout
Official Meilisearch driver for Laravel Scout. Make your Eloquent models instantly searchable with fast, typo-tolerant full-text search, filtering, sorting, custom ranking rules, and simple index configuration—all through familiar Scout model methods.
MeiliSearch integration for Laravel Scout
Frequently asked questions about Meilisearch Laravel Scout
- What is meilisearch/meilisearch-laravel-scout used for?
- It is the official Meilisearch driver for Laravel Scout, used to make Eloquent models searchable with fast, typo-tolerant full-text search. You add Scout's Searchable trait, configure the Meilisearch driver, and query through familiar model search methods with filtering, sorting, facets, and pagination. It fits Laravel applications that already use Scout and want a Meilisearch-backed search index.
- How do I install and configure meilisearch-laravel-scout in Laravel?
- The usual flow is Composer install, publish or configure Laravel Scout, set SCOUT_DRIVER=meilisearch plus the Meilisearch host and key environment values, add the Searchable trait to one model, define toSearchableArray, and run scout:import. You then verify with a simple Model::search('term')->get() query. Be aware that this 2021 package may not resolve on a modern Laravel stack without abandoned-package overrides.
- Does this package support Laravel 10 or Laravel 11?
- Not reliably. The last release is from 2021 and belongs to the Laravel 6–8 and Scout 8 generation, and it pins meilisearch/meilisearch-php at ^0.17. On Laravel 10 or 11 you should expect dependency resolution failures or a need for abandoned-package overrides in composer.json. Treat modern Laravel support as unproven until a spike confirms it.
- Which Meilisearch server version is compatible with this Laravel Scout driver?
- Its meilisearch-php ^0.17 dependency targets roughly Meilisearch server 0.21+ from the 2020–2021 era, not current server releases. Pin your Meilisearch image tag and check the client compatibility matrix rather than floating the server version. Version mismatch often appears as opaque 400 errors on settings updates rather than a clear version error.
- Is meilisearch/meilisearch-laravel-scout still maintained?
- No. The repository is archived, the last release was 2021-03-10, and the package is pre-1.0 with no security patches, compatibility updates, or maintainer escalation path. It should be treated as a legacy artifact for maintenance-mode applications already locked to that generation. New adoption should be handled as a migration assessment, not a dependency review.
- Is it safe to use in production?
- Only in a maintenance-mode application already pinned to the matching Laravel, Scout, and Meilisearch versions, and only with explicit risk acceptance. The risks include certain abandonment, high ecosystem drift, moderate version coupling, silent failures, and correctness footguns such as soft-delete handling and filterable-attribute configuration. Because indexing is queue-driven, a successful write is also not immediately queryable.
- Why are my Meilisearch results not showing up after indexing in Laravel Scout?
- Indexing through Scout is queued and asynchronous, so a successful model save or scout:import does not guarantee documents are immediately queryable. Run queue workers, check Meilisearch task status, and confirm the index name and settings match what the application expects. Client/server mismatches and index drift can also produce plausible-looking wrong results instead of clear crashes.
- What are the alternatives or successor to this archived package?
- Verify whether Meilisearch has folded Scout driver support into the current meilisearch-php client or shipped a successor package before planning. Either way, this archived 2021 driver is not the long-term path; plan a migration to the current supported Meilisearch Laravel integration or another Scout-compatible search engine. If you must stay on the legacy stack, pin the server image and treat the work as a migration ticket.
- Can I use filtering, sorting, facets, and pagination with this driver?
- Yes, the package supports filterable and sortable attributes, facets, ranking rules, synonyms, and Scout pagination. You must still declare filterable attributes in the Meilisearch index settings, or filters will fail or behave unexpectedly. Pagination caps such as maxTotalHits and index drift are common causes of results that look correct but are wrong.
- How should I test or evaluate this package before adopting it?
- Run a time-boxed spike rather than reading the README alone. Resolve Composer dependencies against your actual PHP, Laravel, and Scout versions without ignore-platform-reqs or abandoned-package flags, start a pinned Meilisearch server image, index one model, and test filters, sorts, pagination, soft deletes, queue workers, and task status. If dependency resolution fails, stop and treat the work as a migration instead of an adoption.
Weaver
How can I help you explore Laravel packages today?