PHPackages                             andydefer/laravel-fuzzy - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search & Filtering](/categories/search)
4. /
5. andydefer/laravel-fuzzy

ActiveLibrary[Search & Filtering](/categories/search)

andydefer/laravel-fuzzy
=======================

Powerful fuzzy search system for Laravel with database indexing

v2.0.3(2w ago)050MITPHPPHP ^8.2

Since Jan 9Pushed 1mo agoCompare

[ Source](https://github.com/andydefer/laravel-fuzzy)[ Packagist](https://packagist.org/packages/andydefer/laravel-fuzzy)[ RSS](/packages/andydefer-laravel-fuzzy/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (36)Versions (47)Used By (0)

Laravel Fuzzy Search - Documentation Complète
=============================================

[](#laravel-fuzzy-search---documentation-complète)

[![Latest Version on Packagist](https://camo.githubusercontent.com/60e457fe8ba4736cb92340f9b2bf978537397ac5d079a74d56f9daa12cdd6155/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f796f75722d76656e646f722f6c61726176656c2d66757a7a792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/your-vendor/laravel-fuzzy)[![License](https://camo.githubusercontent.com/2f0b3e4ab1cfee4655f007d5189f28b3823695b479b37d893ab56361f5c2f391/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f796f75722d76656e646f722f6c61726176656c2d66757a7a792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/your-vendor/laravel-fuzzy)

📋 Table des matières
--------------------

[](#-table-des-matières)

1. [Introduction](#-introduction)
2. [Installation rapide](#-installation-rapide)
3. [Préparer vos modèles](#-pr%C3%A9parer-vos-mod%C3%A8les)
    - [Interface et Trait](#interface-et-trait)
    - [Configuration de l'indexation automatique (IndexationLevel)](#configuration-de-lindexation-automatique-indexationlevel)
    - [Méthode `shouldBeIndexed()` - Contrôle d'indexation](#m%C3%A9thode-shouldbeindexed---contr%C3%B4le-dindexation)
    - [Différence entre IndexationLevel et shouldBeIndexed](#diff%C3%A9rence-entre-indexationlevel-et-shouldbeindexed)
    - [Champs protégés](#champs-prot%C3%A9g%C3%A9s-vs-non-prot%C3%A9g%C3%A9s)
4. [Indexation des données](#-indexation-des-donn%C3%A9es)
5. [Recherche](#-recherche)
6. [Formatage des résultats](#-formatage-des-r%C3%A9sultats)
7. [Pipeline de recherche](#-pipeline-de-recherche)
8. [Stratégies de scoring](#-strat%C3%A9gies-de-scoring)
9. [Algorithmes de similarité](#-algorithmes-de-similarit%C3%A9)
10. [Système de cache](#-syst%C3%A8me-de-cache)
11. [Gestion des stop words](#-gestion-des-stop-words)
12. [Optimisation des performances](#-optimisation-des-performances)
13. [Configuration complète](#-configuration-compl%C3%A8te)
14. [Commandes Artisan](#-commandes-artisan)
15. [API de référence](#-api-de-r%C3%A9f%C3%A9rence)
16. [Dépannage](#-d%C3%A9pannage)

---

🚀 Introduction
--------------

[](#-introduction)

**Laravel Fuzzy Search** est un package de recherche floue avancée pour Laravel qui permet de:

- Rechercher malgré les fautes de frappe ("john doe" → "jhon doe")
- Gérer les recherches multi-mots intelligemment
- Trier les résultats par pertinence réelle
- Indexer automatiquement vos modèles Eloquent
- Personnaliser chaque étape du processus de recherche
- **Contrôler finement l'indexation automatique** avec `IndexationLevel`

**Problème résolu** : Implémentez une recherche performante et tolérante aux erreurs directement dans votre base de données, sans dépendre de services externes coûteux comme Algolia ou Meilisearch.

---

📦 Installation rapide
---------------------

[](#-installation-rapide)

```
# 1. Installer via Composer
composer require your-vendor/laravel-fuzzy

# 2. Publier la configuration (optionnel)
php artisan vendor:publish --provider="Fuzzy\FuzzySearchServiceProvider"

# 3. Exécuter les migrations
php artisan migrate

# 4. Indexer vos données
php artisan fuzzy:index
```

---

🎯 Préparer vos modèles
----------------------

[](#-préparer-vos-modèles)

### Interface et Trait

[](#interface-et-trait)

Pour qu'un modèle soit recherchable, il doit implémenter `MustFuzzySearch` et utiliser le trait `FuzzySearchable`:

```