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:
authorize(): Determina si el usuario actual tiene permisos para ejecutar la acción (retornatrueofalse).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.
<?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¿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.