Principali metodi e proprietà della classe Illuminate\Http\Request

La classe Illuminate\Http\Request rappresenta la richiesta HTTP corrente che l’applicazione Laravel sta gestendo. È un involucro (wrapper) avanzato della classe Symfony\Component\HttpFoundation\Request, arricchita con funzionalità specifiche di Laravel.

Esempi pratici

Esempio: https://example.com/prodotti/elettronica?sort=prezzo

//Per ottenere l'intero URL della richiesta corrente, incluso protocollo, host e path:
    $request->fullUrl();
//Restituisce: "https://example.com/prodotti/elettronica?sort=prezzo"

//Per ottenere solo l’URL senza query string:
    $request->url();
//Restituisce: "https://example.com/prodotti/elettronica"

//Per ottenere solo il dominio:
    request()->getHost()
//Restituisce "example.com"

//Per ottenere solo il path
    request()->path()
//Restituisce "prodotti/elettronica"

//Per ottenere un array di tutti i segmenti del path:
$segments = $request->segments();

//Per ottenere solo il primo segmento del path
    $request->segment(1);
//Restituisce "prodotti"
//segment(n) restituisce il segmento n del path (1-based index).

// Per ottenere un array con i parametri della query string
    $request->query();

Principali metodi

Metodo	Descrizione
input($key, $default = null)	Recupera un input dalla richiesta (GET, POST, JSON).
all()	Restituisce tutti gli input della richiesta.
only([...])	Restituisce solo i campi specificati.
except([...])	Restituisce tutti gli input tranne quelli specificati.
has($key)	Verifica se un input è presente.
filled($key)	Verifica se un input è presente e non vuoto.
boolean($key)	Recupera un valore booleano da un input.
json($key = null, $default = null)	Recupera dati dal payload JSON.
file($key)	Recupera un file caricato.
hasFile($key)	Verifica se un file è stato caricato.
method()	Restituisce il metodo HTTP (GET, POST, ecc.).
isMethod('post')	Verifica il metodo HTTP.
path()	Restituisce il path della richiesta.
url()	Restituisce l’URL completo senza query string.
fullUrl()	Restituisce l’URL completo con query string.
query($key, $default = null)	Recupera un parametro dalla query string.
header($key, $default = null)	Recupera un header.
cookie($key, $default = null)	Recupera un cookie.
ip()	Restituisce l’indirizzo IP del client.
userAgent()	Restituisce lo user agent.
route($param = null)	Recupera i parametri della route.

Proprietà utili

Proprietà	Descrizione
$request->headers	Oggetto HeaderBag con tutti gli header.
$request->cookies	Oggetto ParameterBag con i cookie.
$request->query	Parametri GET.
$request->request	Parametri POST.
$request->files	File caricati.
$request->server	Variabili server.
$request->json	Contenuto JSON decodificato.

Risorse online

• Documentazione ufficiale Laravel: Illuminate\Http\Request API
• Guida Laravel Requests (in italiano): Laravel Italia – Richieste
• Laravel Cheat Sheet: QuickRef Laravel