README

📦 Présentation

PHP Search est une bibliothèque PHP moderne pour la recherche floue dans des fichiers JSONL. Elle offre une solution complète avec indexation persistante, cache des résultats et support multi-index.

Caractéristiques principales

• ✅ Recherche floue basée sur l'analyse de n-grams (2, 3 et 4)
• ✅ Indexation persistante pour des recherches ultra-rapides
• ✅ Cache automatique des résultats (TTL 24h)
• ✅ Multi-index : gérez plusieurs sources indépendantes
• ✅ Streaming : lisez ligne par ligne sans surcharge mémoire
• ✅ Support multi-format : fichiers, dossiers, streams, itérables
• ✅ CLI complet pour l'indexation et la recherche
• ✅ Architecture modulaire avec injection de dépendances
• ✅ Support PHP 8.2+ avec types stricts

🚀 Installation

composer require andydefer/php-search

🎯 Utilisation rapide

En ligne de commande

# Indexer un dossier de fichiers JSONL
./vendor/bin/php-search index ./data

# Rechercher (utilise le dernier index)
./vendor/bin/php-search "Leonard" 10

# Rechercher dans un index spécifique
./vendor/bin/php-search "Cardio" 5 --source=./doctors

En PHP

<?php

declare(strict_types=1);

use AndyDefer\PhpSearch\Engines\SearchEngine;
use AndyDefer\PhpSearch\Configs\EngineConfig;
use AndyDefer\PhpServices\Services\FileSystemService;

// Initialisation
$fileSystem = new FileSystemService();
$config = new EngineConfig(getcwd());
$queryProcessor = $container->get(QueryProcessorInterface::class);
$preFilter = $container->get(PreFilterInterface::class);

$engine = new SearchEngine($queryProcessor, $fileSystem, $config, $preFilter);

// Indexation
$engine->index('./data');

// Recherche
$results = $engine->search('Leonard', 10);

foreach ($results as $result) {
    echo $result['name'] . ' - ' . $result['percentage'] . "%\n";
}

📚 Architecture

Moteurs de recherche

Composants principaux

SearchEngine (principal)
    ├── QueryProcessorInterface → Traitement des requêtes
    ├── PreFilterInterface → Filtrage rapide
    ├── FileSystemInterface → Opérations fichiers
    └── EngineConfig → Configuration

JsonlSearchEngine (direct)
    ├── JsonlService → Lecture JSONL
    ├── QueryProcessorInterface → Traitement des requêtes
    └── PreFilterInterface → Filtrage rapide

📝 API principale

SearchEngine

JsonlSearchEngine

💡 Cas d'utilisation

1. Indexation de logs JSONL

$engine->index('./logs');

// Recherche d'erreurs
$errors = $engine->search('error', 50);

foreach ($errors as $error) {
    echo $error['name'] . "\n";
    echo "Source: {$error['source']}\n";
}

2. Cache de résultats de recherche

// Première recherche (cache miss)
$results = $engine->search('Leonard', 10);

// Deuxième recherche (cache hit - instantané)
$results = $engine->search('Leonard', 10);

3. Multi-index pour différents domaines

$engine->index('./doctors');
$engine->index('./patients');

$doctors = $engine->search('Cardio', 5, './doctors');
$patients = $engine->search('Marie', 5, './patients');

4. Recherche directe sans index

use AndyDefer\PhpSearch\Engines\JsonlSearchEngine;

$directEngine = new JsonlSearchEngine($jsonlService, $fileSystem, $queryProcessor, $preFilter);

// Recherche directe dans un fichier
$results = $directEngine->searchInFile('./data.jsonl', ['name'], 'Leonard', 10);

🔧 CLI - Commandes complètes

# Indexation
./vendor/bin/php-search index ./docs
./vendor/bin/php-search index ./docs/artists.jsonl

# Recherche (dernier index)
./vendor/bin/php-search "Leonard" 10

# Recherche dans un index spécifique
./vendor/bin/php-search "Doctor" 5 --source=./docs2

# Gestion des index
./vendor/bin/php-search --list-indexes
./vendor/bin/php-search --stats --source=./docs
./vendor/bin/php-search --delete-index --source=./docs
./vendor/bin/php-search --clear-cache --source=./docs
./vendor/bin/php-search --clear-cache --source=./docs --query=Leonard

📊 Performance

🔗 Dépendances

• PHP ^8.2 - Langage requis
• andydefer/php-jsonl - Gestion des fichiers JSONL
• andydefer/php-services - Services de base
• andydefer/php-vo - Value objects
• andydefer/domain-structures - Structures de domaine

📜 License

MIT License

👨‍💻 Auteur

Andy Kani - andykanidimbu@gmail.com

🙏 Contributions

Les contributions sont les bienvenues !

📖 Résumé rapide

# CLI
./vendor/bin/php-search index ./data
./vendor/bin/php-search "Leonard" 10
./vendor/bin/php-search --stats
./vendor/bin/php-search --list-indexes

// PHP
$engine->index('./data');
$results = $engine->search('Leonard', 10);

foreach ($results as $result) {
    echo $result['name'] . "\n";
}