Hilari Web

🔍 Lección 29: Formulario de Edición de Usuarios, Carga Elocuente y Reemplazo del Avatar en el Storage 🚀👥

En este vigésimo noveno capítulo nos enfocamos en la actualización de la información del personal del sistema. Diseñamos e implementamos el formulario de edición (edit.blade.php) y programamos la lógica del método update() en el UserController. Explicamos cómo precargar textos traducidos individuales desde el objeto JSON con getTranslation(), cómo gestionar la actualización opcional de contraseñas y cómo reemplazar el avatar antiguo eliminando el archivo obsoleto del disco del servidor para evitar datos basura.

🎯 Lo realizado en este capítulo

• 📐 Maquetación Estética del Formulario de Edición (edit.blade.php): Reutilizamos la estructura del formulario de creación para dar forma a la interfaz de edición, modificando los estilos de las tarjetas hacia los tonos verdes de AdminLTE para identificar los procesos de actualización. Configuramos la etiqueta de apertura con el método POST e inyectamos la directiva @method('PUT') junto al token @csrf para cumplir con los estándares de seguridad de Laravel.
• 🧬 Precarga de Datos Globales y Textos JSON con getTranslation(): Mapeamos los campos del usuario en los inputs correspondientes. Para los datos planos (nombre y correo) implementamos cargas directas combinadas con el helper old(). Para el campo extendido biography, estructuramos las pestañas idiomáticas y extraemos el texto exacto de cada idioma (ES, EN, PT) almacenado en la base de datos utilizando el método $user->getTranslation('biography', 'idioma').
• 🔒 Gestión Opcional de Contraseñas en la Validación: Refactorizamos las reglas de validación en el controlador para que la edición de la contraseña sea opcional. Ajustamos la directiva para que el campo solo valide si el administrador ingresa caracteres (nullable|min:8|confirmed). En la lógica del backend, aplicamos una condicional: si el input viene vacío, el sistema ignora el campo y mantiene el hash actual; de lo contrario, encripta el nuevo valor con Hash::make().
• 🧼 Depuración Física de Avatares en el Servidor: Optimizamos el almacenamiento de archivos adjuntos en el disco local. Dentro del flujo de subida de imágenes, programamos la condicional if ($request->hasFile('avatar')). Si se procesa una nueva fotografía, el controlador ejecuta la directiva Storage::disk('public')->delete('avatars/' . $user->avatar); para borrar físicamente la imagen antigua antes de almacenar el nuevo archivo binario, manteniendo el servidor limpio de archivos huérfanos.
• 🔔 Persistencia Multiidioma y Despachador de Alertas: Actualizamos el objeto utilizando los métodos de Spatie Translatable para sobreescribir las biografías modificadas y guardamos los cambios con $user->save();. Finalizamos redirigiendo al index y enviando la llave de sesión flash swal_user_updated, permitiendo que el componente maestro de SweetAlert2 notifique el éxito de la operación en el idioma activo.

🗄️ Próximo paso

Con la edición y actualización de usuarios completada al 100% —abarcando validaciones condicionales, reemplazo de imágenes en el storage y persistencia de datos JSON—, el módulo está casi cerrado. En la próxima lección (Capítulo 30), abordaremos la última acción del CRUD de personal: el método de destrucción (destroy), donde integraremos el modal de confirmación reactivo de SweetAlert2 en tres idiomas y eliminaremos de raíz el registro junto a su avatar del servidor. ¡Nos vemos en el próximo video! 🐾