Tema 7 · Form Requests

7. Validación Robusta con Form Requests para Endpoints POST, PUT y PATCH

Aísla la lógica de validación fuera de los controladores con clases Form Request dedicadas y reglas como Rule::unique, required, numeric y exists.

Separación de Responsabilidades: Controladores Delgados

Escribir arrays de validación gigantescos directamente dentro de los métodos del controlador ensucia el código y dificulta la reutilización. La arquitectura limpia de Laravel promueve el uso de Form Requests dedicados.

Para generar un Form Request se utiliza:

php artisan make:request Api/V1/StoreProductoRequest
Diagrama Técnico: Ciclo de Vida de Validación con Form Requests en Laravel

Si los datos fallan las reglas, Laravel aborta inmediatamente con HTTP 422 sin tocar el código del controlador.

Métodos authorize() y rules()

  • authorize(): Retorna un booleano. Si devuelve false, Laravel aborta con 403 Forbidden antes de validar nada. Ideal para comprobar si el usuario tiene rol para crear productos.
  • rules(): Define las reglas de validación (required, string, min, max, numeric, exists, unique).
  • $request->validated(): Dentro del controlador, este método devuelve únicamente los campos validados, protegiendo contra inyecciones de campos maliciosos (Mass Assignment Protection).

⚡ Clase StoreProductoRequest Completa y Uso en Controlador

Ejemplo de Form Request con reglas de negocio estrictas e inserción segura en el controlador:

app/Http/Requests/StoreProductoRequest.php
Solo lectura
<?php

namespace App\Http\Requests\Api\V1;

use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;

class StoreProductoRequest extends FormRequest
{
    public function authorize(): bool
    {
        // Autorizar a cualquier usuario autenticado
        return true;
    }

    public function rules(): array
    {
        return [
            'nombre'       => ['required', 'string', 'min:3', 'max:150'],
            'codigo_sku'   => ['required', 'string', Rule::unique('productos', 'codigo_sku')],
            'precio'       => ['required', 'numeric', 'min:0.01'],
            'stock'        => ['required', 'integer', 'min:0'],
            'categoria_id' => ['required', 'integer', 'exists:categorias,id'],
        ];
    }
}

// -------------------------------------------------------------
// En el ProductoController:
// public function store(StoreProductoRequest $request): JsonResponse
// {
//     $producto = Producto::create($request->validated());
//     return (new ProductoResource($producto))
//         ->response()
//         ->setStatusCode(201);
// }
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué en el controlador se debe utilizar "$request->validated()" en lugar de "$request->all()" al guardar datos en la base de datos?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar APIs RESTful con Laravel, Resources & Sanctum 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.