13. Manejo de Sesiones, Mensajes Flash y Almacenamiento de Archivos (Storage & Disks)
Comunica estados con mensajes flash (with('success')), sube imágenes con $request->file(), discos locales y enlace simbólico storage:link.
Mensajes Flash de Sesión: Comunicación Efímera
Un Mensaje Flash es un dato que se almacena en la sesión del usuario únicamente durante la siguiente petición HTTP y luego se destruye automáticamente. Es la técnica estándar para confirmar que una acción (como guardar, actualizar o borrar) fue exitosa.
// En el controlador tras procesar un formulario:
return redirect()->route('cursos.index')
->with('success', '¡Curso matriculado correctamente!');
Y en la vista Blade se captura con session('success'):
@if(session('success'))
<div class="alert alert-success alert-dismissible fade show">
{{ session('success') }}
</div>
@endif
Subida y Almacenamiento de Archivos (Storage)
Laravel incluye un potente sistema de archivos basado en la librería Flysystem. En lugar de lidiar con funciones nativas riesgosas como move_uploaded_file(), utilizas la fachada Storage y el objeto UploadedFile.
La configuración se define en config/filesystems.php, ofreciendo varios "discos":
local: Guarda archivos enstorage/app/private/(privados, no accesibles por URL).public: Guarda archivos enstorage/app/public/(para avatares, fotos de cursos, comprobantes públicos).s3: Almacenamiento en la nube en Amazon S3, Cloudflare R2 o DigitalOcean Spaces sin cambiar una sola línea de código.
El Enlace Simbólico Crucial: storage:link
Por seguridad, los archivos subidos al disco public se guardan en storage/app/public/ (fuera del DocumentRoot público). Para que el navegador pueda cargarlos como http://sitio.com/storage/avatares/foto.jpg, debes crear un enlace simbólico ejecutando:
php artisan storage:link
Este comando crea un acceso directo de public/storage hacia storage/app/public.
⚡ Controlador Completo para Subir Avatar o Portada de Curso
Validación de tipos de imagen, almacenamiento seguro en disco public y borrado previo.
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Illuminate\Http\RedirectResponse;
use Illuminate\Support\Facades\Storage;
class AvatarController extends Controller
{
public function update(Request $request): RedirectResponse
{
// 1. Validar que sea un archivo de imagen real (máximo 2 MB)
$request->validate([
'avatar' => ['required', 'image', 'mimes:jpeg,png,webp', 'max:2048'],
]);
$user = auth()->user();
// 2. Si ya tenía una foto previa, eliminarla del disco para no acumular basura
if ($user->avatar_path && Storage::disk('public')->exists($user->avatar_path)) {
Storage::disk('public')->delete($user->avatar_path);
}
// 3. Guardar el nuevo archivo con un nombre hash aleatorio seguro en 'storage/app/public/avatares'
$path = $request->file('avatar')->store('avatares', 'public');
// 4. Actualizar la ruta en la base de datos
$user->update(['avatar_path' => $path]);
// 5. Redireccionar con mensaje flash
return back()->with('success', '¡Foto de perfil actualizada correctamente!');
}
}
// Para mostrar la imagen en Blade:
// <img src="{{ Storage::url($user->avatar_path) }}" alt="Avatar">
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Para qué sirve ejecutar el comando "php artisan storage:link" en Laravel?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Laravel Framework Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.