Validazione

Cos’è la validazione

La validazione consiste nel verificare che i dati inviati dall’utente soddisfino il formato e le condizioni attese. Laravel offre una funzionalità di validazione semplice e potente tramite il metodo validate dell’oggetto request o tramite classi form request dedicate.

Validazione nel controller

Uso di `$request->validate()`

Chiamare $request->validate() all’interno del metodo del controller è il modo più semplice di validare. Se la validazione fallisce, Laravel reindirizza automaticamente l’utente alla schermata precedente e salva gli errori in sessione. Definisci le route.

use App\Http\Controllers\PostController;

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

Crea il controller.

<?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',
        ]);

        // Salva il post con i dati validati...

        return redirect('/posts');
    }
}

Al metodo validate passi un array con nome del campo come chiave e regole come valore. Puoi separare le regole con il pipe | o indicarle come array.

// Separazione con pipe
'title' => 'required|string|max:255',

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

Regole di validazione principali

Regola	Descrizione
`required`	Il valore deve esistere e non essere vuoto
`string`	Deve essere una stringa
`email`	Deve essere un’email valida
`min:valore`	Lunghezza minima della stringa o valore minimo del numero
`max:valore`	Lunghezza massima della stringa o valore massimo del numero
`unique:tabella`	Il valore deve essere univoco nella tabella indicata
`nullable`	Consente anche il valore `null`
`integer`	Deve essere un intero
`boolean`	Deve essere un valore booleano (`true`/`false`, `1`/`0`, ecc.)
`date`	Deve essere una data valida
`confirmed`	Deve corrispondere al campo `nomecampo_confirmation`
`array_keys:chiave1,chiave2,...`	Le chiavi dell’array sono limitate a quelle indicate

Puoi consultare tutte le regole disponibili nella documentazione ufficiale.

Validare le chiavi di un array

La regola array_keys verifica che il valore in oggetto sia un array PHP e che tutte le chiavi siano contenute nell’elenco fornito. Deve essere specificata almeno una chiave.

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

Con gli oggetti Rule, usa il metodo Rule::arrayKeys.

use Illuminate\Validation\Rule;

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

Uso dei dati validati

Il valore restituito da validate è un array che contiene solo i dati che hanno superato la validazione. Puoi usarli in modo sicuro come dati affidabili.

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

// $validated ha la forma ['title' => '...', 'body' => '...']
Post::create($validated);

Visualizzazione degli errori in Blade

Se la validazione fallisce, Laravel rende automaticamente disponibile in tutte le viste la variabile $errors. Se ne occupa il middleware ShareErrorsFromSession incluso nel gruppo web.

Mostrare tutti gli errori in un elenco

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

Mostrare gli errori per singolo campo

Con la direttiva @error puoi mostrare inline l’errore di un campo specifico.

<label for="title">Titolo</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('nomecampo') puoi ripopolare il form con i valori inseriti dall’utente anche dopo un fallimento della validazione.

Form request

Cosa sono le form request

Quando la logica di validazione diventa complessa, è utile estrarla in classi “form request”. Una form request è una classe request personalizzata che raccoglie in un’unica classe la logica di validazione e di autorizzazione.

Creazione di una form request

Genera una classe form request con il comando Artisan make:request.

php artisan make:request StorePostRequest

Viene generato app/Http/Requests/StorePostRequest.php.

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StorePostRequest extends FormRequest
{
    /**
     * Determina se l'utente ha il diritto di eseguire questa richiesta
     */
    public function authorize(): bool
    {
        return true;
    }

    /**
     * Restituisce le regole di validazione da applicare a questa richiesta
     *
     * @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',
        ];
    }
}

Metodo `rules()`

Restituisce le regole di validazione come array. Stesso formato dell’array passato a validate del controller.

Metodo `authorize()`

Determina se l’utente è autorizzato a eseguire la richiesta. Restituendo true l’autorizzazione è concessa; restituendo false viene restituita automaticamente una response 403. Se vuoi consentire solo agli utenti autenticati puoi verificare con auth()->check(). Nel tutorial è sufficiente restituire true.

Se authorize restituisce false, il metodo del controller non viene eseguito e viene restituita una response 403 Forbidden.

Iniezione nel controller

Basta indicare la form request come type hint del metodo del controller. La validazione viene eseguita prima che il controller venga chiamato, quindi non serve scriverla nel metodo.

use App\Http\Requests\StorePostRequest;

class PostController extends Controller
{
    public function store(StorePostRequest $request): RedirectResponse
    {
        // Se sei qui, la validazione è già passata

        $validated = $request->validated();

        Post::create($validated);

        return redirect('/posts');
    }
}

Con $request->validated() ottieni solo i dati validati.

Specificare complessità e lunghezza della password

L’oggetto Rule Password permette di specificare insieme la complessità della password e il numero minimo/massimo di caratteri.

use Illuminate\Validation\Rules\Password;

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

min() specifica il numero minimo di caratteri e max() il numero massimo. Impostare max() permette di consentire password complesse dichiarando al contempo un limite superiore assunto dallo storage e dalle integrazioni con servizi di terze parti.

Esempio pratico: creazione e salvataggio di un form di post

Il flusso completo dalla visualizzazione del form all’invio, validazione e salvataggio.

Definizione delle route

use App\Http\Controllers\PostController;

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

Creazione della 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;
}

Implementazione del controller

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');
    }
}

Creazione del template Blade

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

<h1>Nuovo 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">Titolo</label>
        <input
            id="title"
            type="text"
            name="title"
            value="{{ old('title') }}"
        />
        @error('title')
            <span>{{ $message }}</span>
        @enderror
    </div>

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

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

Nei form Blade includi sempre la direttiva @csrf. Senza il token CSRF Laravel restituisce l’errore 419.

Prossimi passi

Richieste HTTP

Rivedi come ottenere i dati usando l’oggetto request.

Introduzione

Nozioni di base

Gestione delle richieste

Database

Autenticazione

Helper e comunicazione esterna

Test e deployment

Supporto allo sviluppo con AI

Cos’è la validazione

Validazione nel controller

Uso di `$request->validate()`

Regole di validazione principali

Validare le chiavi di un array

Uso dei dati validati

Visualizzazione degli errori in Blade

Mostrare tutti gli errori in un elenco

Mostrare gli errori per singolo campo

Form request

Cosa sono le form request

Creazione di una form request

Metodo `rules()`

Metodo `authorize()`

Iniezione nel controller

Specificare complessità e lunghezza della password

Esempio pratico: creazione e salvataggio di un form di post

Prossimi passi

Richieste HTTP

​Cos’è la validazione

​Validazione nel controller

​Uso di $request->validate()

​Regole di validazione principali

​Validare le chiavi di un array

​Uso dei dati validati

​Visualizzazione degli errori in Blade

​Mostrare tutti gli errori in un elenco

​Mostrare gli errori per singolo campo

​Form request

​Cosa sono le form request

​Creazione di una form request

​Metodo rules()

​Metodo authorize()

​Iniezione nel controller

​Specificare complessità e lunghezza della password

​Esempio pratico: creazione e salvataggio di un form di post

​Prossimi passi

Richieste HTTP

Cos’è la validazione

Validazione nel controller

Uso di `$request->validate()`

Regole di validazione principali

Validare le chiavi di un array

Uso dei dati validati

Visualizzazione degli errori in Blade

Mostrare tutti gli errori in un elenco

Mostrare gli errori per singolo campo

Form request

Cosa sono le form request

Creazione di una form request

Metodo `rules()`

Metodo `authorize()`

Iniezione nel controller

Specificare complessità e lunghezza della password

Esempio pratico: creazione e salvataggio di un form di post

Prossimi passi