laravel_elasticsearch_scout

API Laravel 11 Elasticsearch 8 avec référentiel et modèle de service

Ce projet montre comment intégrer Elasticsearch 8 dans une application Laravel 11 en utilisant le modèle de référentiel et de service pour une architecture propre et maintenable. Il présente la construction d'une API RESTful qui exploite Elasticsearch pour des capacités de recherche puissantes.

Caractéristiques

• Laravel 11 et Elasticsearch 8: utilise les dernières versions des deux cadres.
• Référentiel et modèle de service: favorise l'organisation du code, la séparation des préoccupations et la testabilité.
• API RESTFul: fournit des points de terminaison pour interagir avec les données, alimentées par Elasticsearch.
• Trait requêtenable: offre une solution réutilisable pour appliquer des filtres complexes à des modèles éloquents dans les référentiels.
• Mises à jour automatique de l'index: tire parti de babenkoivan/elastic-scout-driver et babenkoivan/elastic-scout-driver-plus Packages pour garantir que les indices Elasticsarch sont automatiquement mis à jour lorsque les modèles sont créés, mis à jour ou supprimés.

Installation

1. Clone le référentiel:

   git clone https://github.com/ninhhuynh1999/laravel_elasticsearch_books.git

2. Installez les dépendances du compositeur:

   composer install

3. Configurer l'environnement:
   • Copier .env.example à .env et mettre à jour la base de données et les informations d'identification ElasticSearch.
   • Configurez vos détails de connexion ElasticSearch dans le fichier config/elastic.php .
4. Générer la clé d'application:

   php artisan key:generate

5. Exécuter les migrations et les semets (facultatif):

   php artisan migrate --seed 

Usage

1. Démarrez Elasticsearch: reportez-vous à la documentation ElasticSearch pour démarrer votre serveur Elasticsearch.
2. Indexez vos données: utilisez les commandes artisanales fournies ou indexez par programme vos modèles dans Elasticsearch.
3. Explorez l'API: l'application exposera les points de terminaison de l'API à la recherche, au filtre et interagira avec vos données. Reportez-vous à la documentation de l'API pour des critères de terminaison spécifiques et des exemples d'utilisation.

Structure du projet

 app/
├── Classes/       // DTOs (Data Transfer Objects), Request Filters, etc. 
├── Models/         // Eloquent models
├── Repositories/    // Repository interfaces and implementations
├── Services/        // Service interfaces and implementations
├── Traits/          // Reusable traits, including the "Queryable" trait
routes/
    api.php       // API routes

Technologies clés

• PHP 8.1+
• Laravel 11
• Elasticsearch 8
• Babenkoivan / Elastic-Scout-Driver
• Babenkoivan / Elastic-Scout-Driver-Plus

Contributif

N'hésitez pas à contribuer à ce projet en soumettant des problèmes ou en tirant des demandes.

Licence

Ce projet est autorisé sous la licence du MIT.