Validación

¿Qué es la validación?

Validar consiste en comprobar que los datos enviados por el usuario cumplen el formato y las condiciones esperadas. Laravel ofrece validación sencilla y potente mediante el método validate del objeto Request o mediante clases form request dedicadas.

Validación en el controlador

Uso de `$request->validate()`

Llamar a $request->validate() en el método del controlador es la forma más sencilla. Ante un fallo, Laravel redirige automáticamente a la pantalla anterior y guarda los errores en la sesión. Define las rutas:

use App\Http\Controllers\PostController;

Route::get('/post/create', [PostController::class, 'create']);
Route::post('/post', [PostController::class, 'store']);

Crea el controlador:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;

class PostController extends Controller
{
    public function create(): View
    {
        return view('post.create');
    }

    public function store(Request $request): RedirectResponse
    {
        $validated = $request->validate([
            'title' => 'required|string|max:255',
            'body'  => 'required|string',
            'email' => 'required|email',
        ]);

        // Guarda el post con los datos validados...

        return redirect('/posts');
    }
}

validate recibe un array cuya clave es el campo y cuyo valor son las reglas. Las reglas se separan con | o se pasan como array.

// Separadas por tuberías
'title' => 'required|string|max:255',

// Como array
'title' => ['required', 'string', 'max:255'],

Reglas de validación principales

Regla	Descripción
`required`	El valor está presente y no vacío
`string`	Es un string
`email`	Formato de correo válido
`min:valor`	Longitud o valor numérico mínimo
`max:valor`	Longitud o valor numérico máximo
`unique:tabla`	El valor es único en la tabla
`nullable`	Se permite `null`
`integer`	Es entero
`boolean`	Booleano (`true`/`false`, `1`/`0`, etc.)
`date`	Formato de fecha válido
`confirmed`	Coincide con el campo `nombre_confirmation`
`array_keys:clave1,clave2,...`	Las claves del array se limitan a las claves indicadas

Consulta la lista completa en la documentación oficial.

Validar las claves de un array

La regla array_keys verifica que el valor objetivo es un array de PHP y que todas sus claves están contenidas en la lista indicada. Debes especificar al menos una clave.

'user' => ['array_keys:name,username'],

Cuando uses objetos de regla, utiliza el método Rule::arrayKeys.

use Illuminate\Validation\Rule;

'user' => [Rule::arrayKeys('name', 'username')],

Uso de los datos validados

El retorno de validate es un array solo con los datos que pasaron la validación. Puedes usarlos como datos de confianza.

$validated = $request->validate([
    'title' => 'required|string|max:255',
    'body'  => 'required|string',
]);

// $validated con formato ['title' => '...', 'body' => '...']
Post::create($validated);

Mostrar errores en Blade

Ante un fallo, Laravel hace la variable $errors disponible en todas las vistas. Lo gestiona el middleware ShareErrorsFromSession del grupo web.

Listar todos los errores

@if ($errors->any())
    <ul>
        @foreach ($errors->all() as $error)
            <li>{{ $error }}</li>
        @endforeach
    </ul>
@endif

Mostrar el error de un campo

Con la directiva @error muestras el error de un campo en línea.

<label for="title">Título</label>

<input
    id="title"
    type="text"
    name="title"
    value="{{ old('title') }}"
    class="@error('title') is-invalid @enderror"
/>

@error('title')
    <div class="error-message">{{ $message }}</div>
@enderror

Con old('nombre_del_campo') puedes volver a rellenar el valor introducido por el usuario tras un fallo de validación.

Form requests

¿Qué es una form request?

Cuando la lógica de validación se vuelve compleja, extraerla a una clase “form request” es una buena opción. Una form request es una clase de solicitud personalizada que agrupa validación y autorización.

Crear una form request

Genera la clase con el comando Artisan make:request.

php artisan make:request StorePostRequest

Se crea app/Http/Requests/StorePostRequest.php.

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StorePostRequest extends FormRequest
{
    /**
     * Determina si el usuario está autorizado a realizar esta solicitud
     */
    public function authorize(): bool
    {
        return true;
    }

    /**
     * Devuelve las reglas de validación a aplicar
     *
     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
     */
    public function rules(): array
    {
        return [
            'title' => 'required|string|max:255',
            'body'  => 'required|string',
            'email' => 'required|email|unique:posts',
        ];
    }
}

El método `rules()`

Devuelve las reglas de validación como array. El formato es el mismo que en validate.

El método `authorize()`

Determina si la solicitud está autorizada. Si devuelve true, la autorización pasa; si devuelve false, se responde automáticamente con 403. Para permitir solo a usuarios autenticados, puedes comprobar con auth()->check(). En tutoriales basta con devolver true.

Si authorize devuelve false, el método del controlador no se ejecuta y se responde 403 Forbidden.

Inyección en el controlador

Basta con tipar la form request en el método del controlador para usarla. La validación se ejecuta antes de entrar al método, así que no necesitas escribir código de validación dentro.

use App\Http\Requests\StorePostRequest;

class PostController extends Controller
{
    public function store(StorePostRequest $request): RedirectResponse
    {
        // Al llegar aquí, ya se validó

        $validated = $request->validated();

        Post::create($validated);

        return redirect('/posts');
    }
}

Con $request->validated() obtienes solo los datos validados.

Especificar la complejidad y la longitud de una contraseña

El objeto de regla Password te permite especificar la complejidad y el número mínimo/máximo de caracteres de una contraseña en el mismo sitio.

use Illuminate\Validation\Rules\Password;

Password::min(16)
    ->max(256)
    ->letters()
    ->mixedCase()
    ->numbers()
    ->symbols();

min() fija el número mínimo de caracteres y max() el máximo. Definir max() te permite admitir contraseñas complejas y, a la vez, declarar un límite superior asumido por el almacenamiento y las integraciones con servicios de terceros.

Ejemplo práctico: crear y guardar un formulario de post

Flujo completo de visualización, envío, validación y guardado.

Definir las rutas

use App\Http\Controllers\PostController;

Route::get('/posts/create', [PostController::class, 'create']);
Route::post('/posts', [PostController::class, 'store']);

Crear la form request

php artisan make:request StorePostRequest

public function rules(): array
{
    return [
        'title' => 'required|string|max:255',
        'body'  => 'required|string',
    ];
}

public function authorize(): bool
{
    return true;
}

Implementar el controlador

use App\Http\Requests\StorePostRequest;
use App\Models\Post;

class PostController extends Controller
{
    public function create(): View
    {
        return view('posts.create');
    }

    public function store(StorePostRequest $request): RedirectResponse
    {
        Post::create($request->validated());

        return redirect('/posts');
    }
}

Crear la plantilla Blade

{{-- resources/views/posts/create.blade.php --}}

<h1>Nuevo post</h1>

@if ($errors->any())
    <ul>
        @foreach ($errors->all() as $error)
            <li>{{ $error }}</li>
        @endforeach
    </ul>
@endif

<form method="POST" action="/posts">
    @csrf

    <div>
        <label for="title">Título</label>
        <input
            id="title"
            type="text"
            name="title"
            value="{{ old('title') }}"
        />
        @error('title')
            <span>{{ $message }}</span>
        @enderror
    </div>

    <div>
        <label for="body">Cuerpo</label>
        <textarea id="body" name="body">{{ old('body') }}</textarea>
        @error('body')
            <span>{{ $message }}</span>
        @enderror
    </div>

    <button type="submit">Publicar</button>
</form>

Incluye siempre @csrf en los formularios Blade. Sin el token CSRF, Laravel devuelve un error 419.

Próximos pasos

Solicitudes HTTP

Repasa cómo obtener datos del objeto Request.

Introducción

Conceptos básicos

Manejo de solicitudes

Base de datos

Autenticación

Helpers y comunicación externa

Pruebas y despliegue

Asistencia de desarrollo con IA

¿Qué es la validación?

Validación en el controlador

Uso de `$request->validate()`

Reglas de validación principales

Validar las claves de un array

Uso de los datos validados

Mostrar errores en Blade

Listar todos los errores

Mostrar el error de un campo

Form requests

¿Qué es una form request?

Crear una form request

El método `rules()`

El método `authorize()`

Inyección en el controlador

Especificar la complejidad y la longitud de una contraseña

Ejemplo práctico: crear y guardar un formulario de post

Próximos pasos

Solicitudes HTTP

​¿Qué es la validación?

​Validación en el controlador

​Uso de $request->validate()

​Reglas de validación principales

​Validar las claves de un array

​Uso de los datos validados

​Mostrar errores en Blade

​Listar todos los errores

​Mostrar el error de un campo

​Form requests

​¿Qué es una form request?

​Crear una form request

​El método rules()

​El método authorize()

​Inyección en el controlador

​Especificar la complejidad y la longitud de una contraseña

​Ejemplo práctico: crear y guardar un formulario de post

​Próximos pasos

Solicitudes HTTP

¿Qué es la validación?

Validación en el controlador

Uso de `$request->validate()`

Reglas de validación principales

Validar las claves de un array

Uso de los datos validados

Mostrar errores en Blade

Listar todos los errores

Mostrar el error de un campo

Form requests

¿Qué es una form request?

Crear una form request

El método `rules()`

El método `authorize()`

Inyección en el controlador

Especificar la complejidad y la longitud de una contraseña

Ejemplo práctico: crear y guardar un formulario de post

Próximos pasos