Tema 13 · Sesiones & Storage

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 en storage/app/private/ (privados, no accesibles por URL).
  • public: Guarda archivos en storage/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.

AvatarController.php
Solo lectura
<?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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.