README

Este paquete proporciona una serie de utilidades y servicios para acelerar el desarrollo de aplicaciones Symfony en el ecosistema Develia.

Características principales

• Controladores Base:

  • ApiController: Clase base para controladores de API.
  • RestController: Implementación básica para controladores REST con métodos GET, POST, PUT y DELETE mapeados automáticamente.
  • BaseCrudController: Facilitador para operaciones CRUD estándar.

• Servicios de Gestión:

  • SettingsManager: Interfaz y servicio para gestionar configuraciones dinámicas (con soporte para base de datos y caché).
  • DatabaseLogger: Logger compatible con PSR-3 que persiste los registros en la base de datos (tablas log_entry y log_entry_meta).
  • OpenAiService: Integración simplificada con la API de OpenAI.
  • TransactionManager: Utilidad para envolver ejecuciones en transacciones de base de datos.
  • LockManager: Gestión de bloqueos (locks) para evitar condiciones de carrera.

• Seguridad:

  • StaticApiKeyAuthenticator: Autenticador sencillo mediante una clave API estática enviada en las cabeceras.

• Extensiones Twig:

  • DateExtension: Filtros adicionales para el manejo de fechas en plantillas.

• Utilidades:

  • Helpers para manejo de anotaciones, rutas y respuestas XML.

Requisitos

• PHP 8.1 o superior.
• Symfony 5.4 / 6.0 o superior.
• Dependencia de develia/commons.

Instalación

Instala el paquete vía Composer:

composer require develia/symfony

Asegúrate de registrar el bundle en tu archivo config/bundles.php si no se hace automáticamente:

return [
    // ...
    Develia\Symfony\DeveliaBundle::class => ['all' => true],
];

Configuración

Puedes configurar los servicios en tus archivos de configuración de Symfony (ej. config/packages/develia.yaml). Consulta los servicios disponibles en el contenedor de servicios de Symfony.

Licencia

Propiedad de Antonio Gil Espinosa. Todos los derechos reservados.