laravel_elasticsearch_scout

API de Laravel 11 Elasticsearch 8 con repositorio y patrón de servicio

Este proyecto demuestra cómo integrar ElasticSearch 8 en una aplicación Laravel 11 utilizando el repositorio y el patrón de servicio para una arquitectura limpia y mantenible. Muestra la construcción de una API RESTful que aprovecha ElasticSearch para potentes capacidades de búsqueda.

Características

• Laravel 11 y Elasticsearch 8: utiliza las últimas versiones de ambos marcos.
• Repositorio y patrón de servicio: promueve la organización del código, la separación de las preocupaciones y la capacidad de prueba.
• API Restful: proporciona puntos finales para interactuar con datos, impulsados ​​por Elasticsearch.
• Rasgo de consulta: ofrece una solución reutilizable para aplicar filtros complejos a modelos elocuentes dentro de repositorios.
• Actualizaciones de índice automático: aprovecha los paquetes babenkoivan/elastic-scout-driver y babenkoivan/elastic-scout-driver-plus para garantizar que los índices de Elasticsearch se actualicen automáticamente cuando los modelos se crean, actualizan o se eliminen.

Instalación

1. Clon el repositorio:

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

2. Instalar dependencias del compositor:

   composer install

3. Configurar entorno:
   • Copie .env.example a .env y actualice las credenciales de la base de datos y elasticsearch.
   • Configure sus detalles de conexión Elasticsearch en el archivo config/elastic.php .
4. Generar la clave de aplicación:

   php artisan key:generate

5. Ejecutar migraciones y sembradoras (opcionales):

   php artisan migrate --seed 

Uso

1. Iniciar Elasticsearch: consulte la documentación Elasticsearch para iniciar su servidor Elasticsearch.
2. Indexe sus datos: use los comandos artesanales proporcionados o indexe programáticamente sus modelos a Elasticsearch.
3. Explore la API: la aplicación expondrá puntos finales de API para buscar, filtrar e interactuar con sus datos. Consulte la documentación de la API para puntos finales específicos y ejemplos de uso.

Estructura de proyectos

 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

Tecnologías clave

• PHP 8.1+
• Laravel 11
• Elasticsearch 8
• babenkoivan/elástico-scout-conductor
• Babenkoivan/elástico-scout-conductor-plus

Que contribuye

Siéntase libre de contribuir a este proyecto enviando problemas o solicitudes.

Licencia

Este proyecto tiene licencia bajo la licencia MIT.