Laravel Settings Kit
Laravel Settings Kit es un paquete para gestionar configuraciones en aplicaciones Laravel. Las configuraciones se definen en el código, con su tipo y su valor por defecto, y cada usuario (o cualquier otro modelo) puede tener un valor propio.
Definiciones en el código
Los tipos, los valores por defecto y quién puede personalizar cada configuración se declaran en el archivo de configuración o con un constructor fluido, y se versionan con la aplicación. No hacen falta seeders y todos los entornos quedan iguales. En la base de datos solo se guardan los valores que no coinciden con el por defecto.
Valores por usuario o por modelo
Con el trait HasSettings, cada registro de un modelo (usuarios, equipos, clientes...) lee primero su valor, después el global y, si no hay ninguno, el por defecto. Cuando cambias un valor global, se aplica a todos los que no lo han personalizado.
Tipos y validación
Acepta texto, booleano, entero, decimal, array, lista de opciones y enums de PHP, además de cualquier regla de validación de Laravel. Los datos de un formulario o de una petición JSON se pueden pasar directamente: "1" se convierte en true y "42" en 42. Las configuraciones con datos sensibles, como claves de API, se pueden guardar cifradas.
Pantallas de configuración
El método panel() devuelve lo que necesita un formulario de preferencias: etiquetas, descripciones, opciones, valor actual y por defecto, y si el usuario lo ha cambiado. Los textos se traducen con los archivos de idioma habituales de Laravel.
Consultas y caché
Todos los valores globales, o todos los de un usuario, se cargan con una sola consulta, se guardan juntos en caché y se reutilizan durante la petición. Funciona con cualquier driver de caché y con Octane.
Otras herramientas
- Endpoints JSON opcionales, detrás de tu propio middleware de autenticación y tus Gates
- Eventos
SettingUpdatedySettingReseten cada cambio - Directiva Blade
@setting('key') - Comandos Artisan para listar, exportar, importar y limpiar configuraciones
Requisitos
PHP 8.2 o superior y Laravel 11, 12 o 13.
¿Tienes una idea o quieres colaborar?
Si tienes una idea en mente, quieres colaborar en algún proyecto o simplemente quieres hablar de tecnología, escríbenos. Nos gusta conocer gente con ganas de hacer cosas.
Hablemos