Vai al contenuto principale

​
Cos’è l’oggetto Request

Illuminate\Http\Request è la classe che consente di gestire in modo orientato agli oggetti le richieste HTTP ricevute dall’applicazione. Ti dà accesso a tutte le informazioni contenute nella richiesta: dati del form, query string, file, header e altro.

​
Iniezione della Request in un controller

Se annoti con il tipo Illuminate\Http\Request un metodo di un controller, il service container di Laravel inietta automaticamente l’istanza della request. 
<?php

namespace App\Http\Controllers;

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

class UserController extends Controller
{
    public function store(Request $request): RedirectResponse
    {
        $name = $request->input('name');

        // Logica per salvare l'utente...

        return redirect('/users');
    }
}
Puoi usare il type hint allo stesso modo anche nelle closure delle route. 
use Illuminate\Http\Request;

Route::get('/', function (Request $request) {
    // ...
});

​
Uso con i parametri di route

Se un metodo controller riceve anche parametri di route, scrivili dopo Request. 
use App\Http\Controllers\UserController;

Route::put('/user/{id}', [UserController::class, 'update']);

public function update(Request $request, string $id): RedirectResponse
{
    // Accedi ai dati della richiesta con $request e al parametro di route con $id

    return redirect('/users');
}

​
Recupero dei dati della richiesta

​
Ottenere tutti i dati di input

Con il metodo all recuperi tutti i dati di input come array. Funziona sia con richieste da form HTML sia con richieste XHR. 
$input = $request->all();

​
Ottenere un campo specifico

Il metodo input recupera il valore dall’intero payload della richiesta (query string inclusa), indipendentemente dal metodo HTTP. 
$name = $request->input('name');
Puoi indicare un valore predefinito nel secondo argomento se il valore non esiste. 
$name = $request->input('name', 'Sally');
Per gli input di tipo array accedi con la notazione dot. 
$name = $request->input('products.0.name');

$names = $request->input('products.*.name');

​
Ottenere la query string

Il metodo query recupera valori solo dalla query string (dopo il ? nell’URL). 
$name = $request->query('name');

$name = $request->query('name', 'Helen');

// Ottieni tutta la query string come array
$query = $request->query();
input considera sia il corpo della richiesta sia la query string, mentre query considera solo la query string. Usa query se vuoi distinguere i dati POST dai parametri URL.

​
Recupero tipizzato

Oltre a input, ci sono metodi per recuperare i valori specificando il tipo. 
// Ottieni come stringa (istanza Stringable)
$name = $request->string('name')->trim();

// Ottieni come intero
$perPage = $request->integer('per_page');

// Ottieni come booleano ("1", "true", "on", "yes" → true)
$archived = $request->boolean('archived');

// Ottieni come array
$versions = $request->array('versions');

// Ottieni la data come istanza Carbon
$birthday = $request->date('birthday');

​
Proprietà dinamiche

Puoi anche accedere ai campi come proprietà usando direttamente il loro nome. 
$name = $request->name;
Con le proprietà dinamiche, Laravel cerca prima il valore nel payload della richiesta e, se non lo trova, nei parametri di route.

​
Ottenere un sottoinsieme dei dati di input

Con only ed except puoi ottenere un sottoinsieme dei dati di input. 
$input = $request->only(['username', 'password']);

$input = $request->except(['credit_card']);

​
Verifica della presenza di un input

Con il metodo has verifichi che il valore sia presente nella richiesta. 
if ($request->has('name')) {
    // ...
}

// Verifica che siano presenti tutte le chiavi
if ($request->has(['name', 'email'])) {
    // ...
}
Per verificare la presenza escludendo le stringhe vuote usa filled. 
if ($request->filled('name')) {
    // ...
}
Se il valore non esiste oppure è una stringa vuota usa isNotFilled. 
if ($request->isNotFilled('name')) {
    // ...
}

​
Verifica del path e del metodo della richiesta

​
Ottenere e verificare il path

// Ottieni il path (es. "foo/bar")
$uri = $request->path();

// Verifica se corrisponde a un pattern (puoi usare il wildcard *)
if ($request->is('admin/*')) {
    // ...
}

// Verifica se corrisponde a una route con nome
if ($request->routeIs('admin.*')) {
    // ...
}

​
Ottenere l’URL

// URL senza query string
$url = $request->url();

// URL con query string
$urlWithQueryString = $request->fullUrl();

​
Verifica del metodo HTTP

Con isMethod puoi verificare il metodo HTTP. 
$method = $request->method();

if ($request->isMethod('post')) {
    // Elabora solo richieste POST
}

​
Upload di file

​
Recuperare il file caricato

Con il metodo file ottieni il file caricato. Viene restituita un’istanza di Illuminate\Http\UploadedFile. 
$file = $request->file('photo');

// Puoi ottenerlo anche come proprietà dinamica
$file = $request->photo;
Per verificare se il file esiste usa hasFile. 
if ($request->hasFile('photo')) {
    // ...
}

​
Salvataggio del file

Con il metodo store salvi il file nello storage. Il nome del file viene generato automaticamente. 
// Salva nella directory "images" del disk predefinito
$path = $request->photo->store('images');

// Salva su S3
$path = $request->photo->store('images', 's3');
Se vuoi specificare il nome del file usa storeAs. 
$path = $request->photo->storeAs('images', 'filename.jpg');
Quando accetti upload di file, valida sempre il tipo e la dimensione del file. Si consiglia di gestirli in modo sicuro tramite la validazione.

​
Esempio pratico: ricezione dei dati di un form

Esempio di ricezione in un controller dei dati di un form di registrazione utente. 
<?php

namespace App\Http\Controllers;

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

class RegisterController extends Controller
{
    public function store(Request $request): RedirectResponse
    {
        // Ottieni i dati del form
        $name = $request->input('name');
        $email = $request->input('email');
        $password = $request->input('password');

        // Ottieni solo i dati necessari
        $data = $request->only(['name', 'email', 'password']);

        // Logica per creare l'utente...

        return redirect('/dashboard');
    }
}
Definisci la route corrispondente. 
use App\Http\Controllers\RegisterController;

Route::post('/register', [RegisterController::class, 'store']);

​
Prossimi passi

Middleware

Ripassa come usare i middleware per filtrare le richieste.
Ultima modifica il 13 luglio 2026

Argomenti correlati

MiddlewareValidazioneCostruire una SPA con Inertia.jsTest avanzati con PestLaravel Telescope