Routing

Basisrouting

De meest basale Laravel-route neemt een URI en een closure. Zonder ingewikkelde configuratiebestanden definieer je zo eenvoudig routes en hun gedrag.

use Illuminate\Support\Facades\Route;

Route::get('/greeting', function () {
    return 'Hello World';
});

Standaard routebestanden

Alle Laravel-routes definieer je in de routebestanden in de map routes/. Laravel laadt deze bestanden automatisch op basis van de configuratie in bootstrap/app.php. In routes/web.php definieer je de routes voor de browser. Op de routes in dit bestand wordt de web-middlewaregroep toegepast, die sessies, CSRF-bescherming en cookie-encryptie biedt.

use App\Http\Controllers\UserController;

Route::get('/user', [UserController::class, 'index']);

API-routes

Biedt je applicatie een stateless API aan, dan kun je API-routing inschakelen met het Artisan-commando install:api.

php artisan install:api

Het commando install:api installeert Laravel Sanctum en maakt het bestand routes/api.php aan. Sanctum biedt een eenvoudige en robuuste API-token-authenticatieguard voor externe API-consumers, SPA’s en mobiele applicaties.

Route::get('/user', function (Request $request) {
    return $request->user();
})->middleware('auth:sanctum');

De routes in routes/api.php zijn stateless en krijgen de api-middlewaregroep. Bovendien krijgen alle routes automatisch de URI-prefix /api, dus die hoef je niet zelf toe te voegen. Wil je de prefix wijzigen, pas dan het bestand bootstrap/app.php van je applicatie aan.

->withRouting(
    api: __DIR__.'/../routes/api.php',
    apiPrefix: 'api/admin',
    // ...
)

Beschikbare HTTP-methoden

De router kan routes registreren voor alle HTTP-methoden.

Route::get($uri, $callback);
Route::post($uri, $callback);
Route::put($uri, $callback);
Route::patch($uri, $callback);
Route::delete($uri, $callback);
Route::options($uri, $callback);

Voor routes die op meerdere HTTP-methoden reageren gebruik je match of any.

Route::match(['get', 'post'], '/', function () {
    // ...
});

Route::any('/', function () {
    // ...
});

Neem in HTML-formulieren die POST, PUT, PATCH of DELETE versturen naar routes in het web-routebestand altijd de @csrf-directive op. Doe je dat niet, dan wordt het request geweigerd.

Routes die een view teruggeven

Als een route alleen een view hoeft terug te geven, kun je dat beknopt schrijven met Route::view.

Route::view('/welcome', 'welcome');

// Data doorgeven aan de view
Route::view('/welcome', 'welcome', ['name' => 'Taylor']);

Routeparameters

Verplichte parameters

Om een deel van de URL dynamisch op te vangen gebruik je routeparameters. Parameters omsluit je met {} en ontvang je als argument van de routecallback.

Route::get('/user/{id}', function (string $id) {
    return 'Gebruikers-ID: ' . $id;
});

Je kunt ook meerdere parameters definiëren.

Route::get('/posts/{post}/comments/{comment}', function (string $postId, string $commentId) {
    return "Reactie {$commentId} van post {$postId}";
});

Routeparameters mogen geen /-teken bevatten.

Optionele parameters

Om een parameter optioneel te maken zet je een ? achter de parameternaam en geef je het bijbehorende argument een standaardwaarde.

Route::get('/user/{name?}', function (?string $name = null) {
    return $name ?? 'Gast';
});

Route::get('/user/{name?}', function (?string $name = 'Gast') {
    return $name;
});

Parameterbeperkingen met reguliere expressies

Met de where-methode leg je het formaat van een parameter vast via een reguliere expressie.

Route::get('/user/{id}', function (string $id) {
    // ...
})->where('id', '[0-9]+');

Route::get('/user/{name}', function (string $name) {
    // ...
})->where('name', '[a-zA-Z]+');

Veelgebruikte patronen kun je ook met handige hulpmethoden schrijven.

Route::get('/user/{id}/{name}', function (string $id, string $name) {
    // ...
})->whereNumber('id')->whereAlpha('name');

Named routes

Met named routes kun je bij het genereren van URL’s of redirects verwijzen naar de routenaam.

Route::get('/user/profile', function () {
    // ...
})->name('profile');

URL’s genereren voor named routes

Om een URL te genereren op basis van een routenaam gebruik je de route-helper.

// URL genereren
$url = route('profile');

// URL genereren met parameters
$url = route('user.show', ['id' => 1]);

Redirects

return redirect()->route('profile');

Routegroepen

Je kunt gerelateerde routes groeperen en gedeelde instellingen zoals middleware, controllers en prefixes toepassen.

Middleware

Route::middleware(['auth'])->group(function () {
    Route::get('/dashboard', function () {
        // Alleen toegankelijk voor ingelogde gebruikers
    });

    Route::get('/account', function () {
        // Alleen toegankelijk voor ingelogde gebruikers
    });
});

Controllers

Routes die dezelfde controller gebruiken kun je groeperen.

use App\Http\Controllers\OrderController;

Route::controller(OrderController::class)->group(function () {
    Route::get('/orders', 'index');
    Route::post('/orders', 'store');
    Route::get('/orders/{id}', 'show');
});

Prefixes

Je kunt de URI’s van routes een gedeelde prefix geven.

Route::prefix('admin')->group(function () {
    Route::get('/users', function () {
        // Bereikbaar via /admin/users
    });
    Route::get('/posts', function () {
        // Bereikbaar via /admin/posts
    });
});

Routelijst bekijken

Om alle gedefinieerde routes op te sommen gebruik je een Artisan-commando.

php artisan route:list

Wil je ook de middleware-informatie zien, doe dan het volgende:

php artisan route:list -v

Wil je alleen routes tonen die met een bepaalde URI beginnen, doe dan het volgende:

php artisan route:list --path=user

Volgende stap

Views

Leer hoe je views maakt en data doorgeeft vanuit een controller.

Aan de slag

Basis

Request-verwerking

Database

Authenticatie

Helpers en externe communicatie

Testen en deployment

AI-ontwikkelondersteuning

Basisrouting

Standaard routebestanden

API-routes

Beschikbare HTTP-methoden

Routes die een view teruggeven

Routeparameters

Verplichte parameters

Optionele parameters

Parameterbeperkingen met reguliere expressies

Named routes

URL’s genereren voor named routes

Redirects

Routegroepen

Middleware

Controllers

Prefixes

Routelijst bekijken

Volgende stap

Views

​Basisrouting

​Standaard routebestanden

​API-routes

​Beschikbare HTTP-methoden

​Routes die een view teruggeven

​Routeparameters

​Verplichte parameters

​Optionele parameters

​Parameterbeperkingen met reguliere expressies

​Named routes

​URL’s genereren voor named routes

​Redirects

​Routegroepen

​Middleware

​Controllers

​Prefixes

​Routelijst bekijken

​Volgende stap

Views

Basisrouting

Standaard routebestanden

API-routes

Beschikbare HTTP-methoden

Routes die een view teruggeven

Routeparameters

Verplichte parameters

Optionele parameters

Parameterbeperkingen met reguliere expressies

Named routes

URL’s genereren voor named routes

Redirects

Routegroepen

Middleware

Controllers

Prefixes

Routelijst bekijken

Volgende stap