Tema 11 · Validación & CSRF

11. Procesamiento de Formularios, Protección CSRF (@csrf) y Validación con Form Requests

Protege tus formularios contra ataques CSRF, aplica reglas de validación complejas y desacopla la validación con clases FormRequest dedicadas.

Protección Obligatoria contra CSRF (@csrf)

Cross-Site Request Forgery (CSRF) es un ataque donde un sitio web malicioso engaña al navegador de un usuario autenticado para que envíe solicitudes no autorizadas (como cambiar su contraseña o transferir fondos).

En Laravel, el middleware VerifyCsrfToken valida automáticamente que cada petición POST, PUT, PATCH o DELETE incluya un token secreto. En tus formularios Blade solo debes agregar la directiva:

<form method="POST" action="/cursos">
    @csrf
    <!-- Si no incluyes @csrf, Laravel responderá con error HTTP 419 Page Expired -->
</form>

Y para simular verbos como PUT o DELETE en HTML nativo:

<form method="POST" action="/cursos/5">
    @csrf
    @method('PUT')
</form>

Validación con Clases Form Request Dedicadas

En lugar de llenar los controladores con reglas de validación repetitivas, Laravel permite crear clases dedicadas llamadas Form Requests:

php artisan make:request StoreCursoRequest

Esta clase (en app/Http/Requests/StoreCursoRequest.php) contiene dos métodos:

  1. authorize(): Determina si el usuario actual tiene permisos para ejecutar la acción (retorna true o false).
  2. rules(): Define las reglas de validación con el catálogo de validadores de Laravel (required, email, unique, min, max, etc.).

Inyección Automática y Manejo de Errores

En tu controlador, simplemente reemplazas Request $request por tu StoreCursoRequest $request:

public function store(StoreCursoRequest $request)
{
    // Si la validación falla, Laravel redirige automáticamente hacia atrás con los errores y el input previo (old)
    // Si llega a esta línea, los datos ya están 100% validados y limpios:
    $datosValidados = $request->validated();
    Curso::create($datosValidados);

    return redirect()->route('cursos.index')->with('success', 'Guardado.');
}

En tu vista Blade, muestras los errores con las directivas @error y mantienes los datos tipeados con old('campo'):

<input type="text" name="title" value="{{ old('title') }}" class="form-control @error('title') is-invalid @enderror">
@error('title')
    <div class="invalid-feedback">{{ $message }}</div>
@enderror

⚡ Form Request Completo con Reglas y Mensajes Personalizados

Clase StoreCursoRequest con reglas de unicidad, tipos numéricos y mensajes en español.

StoreCursoRequest.php
Solo lectura
<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StoreCursoRequest extends FormRequest
{
    /** Determina si el usuario autenticado puede hacer esta petición */
    public function authorize(): bool
    {
        // Solo usuarios administradores pueden crear cursos
        return auth()->check() && auth()->user()->role === 'admin';
    }

    /** Reglas de validación aplicables a la petición */
    public function rules(): array
    {
        return [
            'title'       => ['required', 'string', 'min:5', 'max:190'],
            'slug'        => ['required', 'string', 'unique:cursos,slug'],
            'summary'     => ['required', 'string', 'max:300'],
            'price_cop'   => ['required', 'numeric', 'min:0', 'max:10000000'],
            'hours'       => ['required', 'integer', 'between:1,300'],
            'is_active'   => ['sometimes', 'boolean'],
        ];
    }

    /** Mensajes de error personalizados en español */
    public function messages(): array
    {
        return [
            'title.required'    => 'El título del curso es completamente obligatorio.',
            'slug.unique'       => 'Ya existe otro curso registrado con ese mismo identificador slug.',
            'price_cop.numeric' => 'El precio debe ser un número válido sin signos ni comas.',
        ];
    }
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué código de estado HTTP devuelve Laravel si envías un formulario POST sin la directiva @csrf?
🦉
¿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.