Skip to main content

Wat is het Request-object?

Illuminate\Http\Request is de klasse waarmee je het HTTP-request dat je applicatie ontvangt objectgeoriënteerd verwerkt. Je hebt toegang tot alle informatie in het request: formulierdata, querystrings, bestanden, headers en meer.

Het request injecteren in een controller

Als je Illuminate\Http\Request type-hint in een controllermethode, injecteert de service container van Laravel automatisch de request-instantie.
In een route-closure kun je op dezelfde manier type-hinten.

Combineren met routeparameters

Ontvangt je controllermethode ook routeparameters, dan zet je de routeparameters na de Request.

Requestdata ophalen

Alle invoerdata ophalen

Met de all-methode haal je alle invoerdata op als array. Dit werkt zowel voor requests vanuit een HTML-formulier als voor XHR-requests.

Een specifiek veld ophalen

De input-methode haalt, ongeacht de HTTP-methode, een waarde op uit de volledige request-payload (inclusief de querystring).
Als tweede argument kun je een standaardwaarde opgeven voor als de waarde niet bestaat.
Array-invoer benader je met de puntnotatie.

De querystring ophalen

De query-methode haalt alleen waarden op uit de querystring (het deel na ? in de URL).
input kijkt zowel naar de request-body als naar de querystring, terwijl query alleen naar de querystring kijkt. Wil je onderscheid maken tussen POST-data van een formulier en URL-parameters, gebruik dan query.

Getypeerd ophalen

Naast input zijn er ook methodes die invoerwaarden met een specifiek type ophalen.

Dynamische properties

Je kunt een veldnaam ook rechtstreeks als property benaderen.
Bij dynamische properties wordt eerst gezocht in de request-payload; wordt daar niets gevonden, dan wordt gezocht in de routeparameters.

Een deel van de invoerdata ophalen

Met only en except haal je een subset van de invoerdata op.

Controleren of invoer aanwezig is

Met de has-methode controleer je of een waarde in het request zit.
Wil je weten of er een waarde aanwezig is die geen lege string is, gebruik dan filled.
Is de waarde afwezig of een lege string, dan gebruik je isNotFilled.

Het pad en de methode van het request controleren

Het pad ophalen en controleren

De URL ophalen

De HTTP-methode controleren

Met isMethod controleer je de HTTP-methode.

Bestandsuploads

Geüploade bestanden ophalen

Met de file-methode haal je een geüpload bestand op. Je krijgt een Illuminate\Http\UploadedFile-instantie terug.
Om te controleren of er een bestand aanwezig is, gebruik je hasFile.

Bestanden opslaan

Met de store-methode sla je een bestand op in de storage. De bestandsnaam wordt automatisch gegenereerd.
Wil je zelf een bestandsnaam opgeven, gebruik dan storeAs.
Accepteer je bestandsuploads, valideer dan altijd het bestandstype en de bestandsgrootte. We raden aan om dit veilig af te handelen met validatie.

Praktijkvoorbeeld: formulierdata ontvangen

Een voorbeeld waarin je de data van een registratieformulier ontvangt in een controller.
Definieer de bijbehorende route.

Volgende stap

Middleware

Bekijk opnieuw hoe je requests filtert met middleware.
Laatst gewijzigd op 6 september 2026