FAQ over de nieuwe appstructuur van Laravel 11+

Er zijn maar weinig configbestanden

In de nieuwe structuur zijn configbestanden die zelden worden aangepast uit het project verwijderd. Voor deze bestanden wordt de config/ binnen het framework gebruikt.De config/ aan de projectkant en de config/ aan de frameworkkant worden samengevoegd, waarbij de projectkant voorrang krijgt. Zodra je iets wilt aanpassen, maak je het bestand aan en wordt het toegepast.

# Bekijk de config binnen het framework
cat vendor/laravel/framework/config/cors.php

# Kopieer naar de projectkant en pas aan
php artisan config:publish cors

$this->validate() en $this->authorize() werken niet in controllers

In de nieuwe structuur van Laravel 11 is App\Http\Controllers\Controller een lege klasse geworden: hij erft niet van Illuminate\Routing\Controller en gebruikt de traits ValidatesRequests / AuthorizesRequests niet.

Laravel 10	Laravel 11
Erft van `Illuminate\Routing\Controller`	Lege klasse
Gebruikt de trait `ValidatesRequests`	Niet aanwezig
Gebruikt de trait `AuthorizesRequests`	Niet aanwezig

Zie: Controller in Laravel 10 vs Controller in Laravel 11Alternatieven:

// Gebruik $request->validate()
public function store(Request $request)
{
    $validated = $request->validate([
        'title' => 'required|string|max:255',
    ]);
}

// Gebruik Gate::authorize()
use Illuminate\Support\Facades\Gate;

public function update(Request $request, Post $post)
{
    Gate::authorize('update', $post);
}

Gebruik je dit vaak, dan kun je App\Http\Controllers\Controller ook terugbrengen naar de Laravel 10-variant.

<?php

namespace App\Http\Controllers;

use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
use Illuminate\Foundation\Validation\ValidatesRequests;
use Illuminate\Routing\Controller as BaseController;

abstract class Controller extends BaseController
{
    use AuthorizesRequests, ValidatesRequests;
}

app/Http/Middleware ontbreekt en ik kan middleware-instellingen niet wijzigen / app/Http/Kernel.php ontbreekt

In de nieuwe structuur is app/Http/Kernel.php vervallen; middleware configureer je nu via withMiddleware() in bootstrap/app.php.

// bootstrap/app.php
->withMiddleware(function (Middleware $middleware) {
    // Alles wat je vroeger via bijvoorbeeld de TrustProxies-middleware instelde, kan nu via methodes van de Middleware-klasse
    $middleware->trustProxies(at: '*');

    // Globale middleware toevoegen
    $middleware->append(\App\Http\Middleware\MyMiddleware::class);

    // Een alias instellen voor routegroepen
    $middleware->alias([
        'my-middleware' => \App\Http\Middleware\MyMiddleware::class,
    ]);

    // Web- / API-middlewaregroepen aanpassen
    $middleware->web(append: [
        \App\Http\Middleware\HandleInertiaRequests::class,
    ]);
})

De bestanden van je eigen middleware maak je nog steeds aan in app/Http/Middleware/.

$this->middleware() werkt niet binnen een controller

$this->middleware() is functionaliteit van Illuminate\Routing\Controller en is dus niet beschikbaar in de lege basiscontroller van de nieuwe structuur.Implementeer in plaats daarvan de interface HasMiddleware en definieer een middleware()-methode.

use Illuminate\Routing\Controllers\HasMiddleware;
use Illuminate\Routing\Controllers\Middleware;

class UserController extends Controller implements HasMiddleware
{
    public static function middleware(): array
    {
        return [
            'auth',
            new Middleware('log', only: ['index']),
            new Middleware('subscribed', except: ['index']),
        ];
    }
}

Vanaf Laravel 13 kun je ook het #[Middleware]-attribute gebruiken.

use Illuminate\Routing\Controllers\HasMiddleware;
use App\Http\Middleware\EnsureTokenIsValid;

#[Middleware(EnsureTokenIsValid::class)]
class UserController extends Controller
{
    // ...
}

Zie: Controller middleware

$this->authorizeResource() bestaat niet

authorizeResource() is afhankelijk van de trait AuthorizesRequests en werkt daarom niet in de lege basiscontroller van de nieuwe structuur.Er zijn meerdere oplossingen.1. De basiscontroller terugbrengen naar de Laravel 10-opzet (het eenvoudigst)

// app/Http/Controllers/Controller.php
use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
use Illuminate\Routing\Controller as BaseController;

abstract class Controller extends BaseController
{
    use AuthorizesRequests;
}

Hiermee kun je $this->authorizeResource() weer gebruiken.2. Het #[Authorize]-attribute van Laravel 13 op elke methode zetten

use Illuminate\Routing\Attributes\Controllers\Authorize;
use App\Models\Post;

class PostController extends Controller
{
    #[Authorize('view', 'post')]
    public function show(Post $post) { /* ... */ }

    #[Authorize('update', 'post')]
    public function update(Request $request, Post $post) { /* ... */ }
}

app/Console/Kernel.php ontbreekt en ik kan de Schedule niet instellen

In de nieuwe structuur is app/Console/Kernel.php vervallen en is de plek voor het instellen van de schedule veranderd.In routes/console.php zetten (aanbevolen):

// routes/console.php
use Illuminate\Support\Facades\Schedule;

Schedule::command('emails:send')->daily();
Schedule::job(new SendEmails)->everyFiveMinutes();

In bootstrap/app.php zetten:

->withSchedule(function (Schedule $schedule) {
    $schedule->command('emails:send')->daily();
})

Ik weet niet hoe ik events en listeners registreer

In de nieuwe structuur is de EventServiceProvider vervallen en is handmatig registreren van events en listeners niet meer nodig.Hoe automatische registratie werkt: zodra je in de handle()-methode van een listenerklasse de eventklasse als type declareert, wordt de listener automatisch geregistreerd.

namespace App\Listeners;

use App\Events\OrderShipped;

class SendShipmentNotification
{
    // Alleen al door de eventklasse als argument van handle() op te geven, wordt deze automatisch geregistreerd
    public function handle(OrderShipped $event): void
    {
        // ...
    }
}

Is handmatige registratie toch nodig, dan doe je dat in AppServiceProvider::boot().

use Illuminate\Support\Facades\Event;

public function boot(): void
{
    Event::listen(
        OrderShipped::class,
        SendShipmentNotification::class,
    );
}

Ik weet niet hoe ik een service provider aan config/app.php toevoeg

In de nieuwe structuur is het beheer van de lijst met service providers verplaatst van config/app.php naar bootstrap/providers.php.

// bootstrap/providers.php
return [
    App\Providers\AppServiceProvider::class,
    App\Providers\MyCustomServiceProvider::class, // ← hier toevoegen
];

Providers die je aanmaakt met artisan make:provider worden hier automatisch aan toegevoegd.

app/Exceptions/Handler.php ontbreekt

In de nieuwe structuur is app/Exceptions/Handler.php vervallen; de afhandeling van excepties configureer je via withExceptions() in bootstrap/app.php.

// bootstrap/app.php
->withExceptions(function (Exceptions $exceptions) {
    // Bepaalde excepties niet rapporteren
    $exceptions->dontReport(InvalidOrderException::class);

    // Aangepaste rendering
    $exceptions->render(function (InvalidOrderException $e, Request $request) {
        return response()->view('errors.invalid-order', status: 500);
    });

    // Redirectdoel bij niet-geauthenticeerde requests wijzigen
    $exceptions->shouldRenderJsonWhen(function (Request $request, Throwable $e) {
        return $request->is('api/*');
    });
})

Ik wil de routing aanpassen

Routes pas je aan via withRouting() in bootstrap/app.php.Een routebestand toevoegen:

->withRouting(
    web: __DIR__.'/../routes/web.php',
    then: function () {
        Route::middleware('web')
            ->prefix('admin')
            ->group(base_path('routes/admin.php'));
    },
)

Volledige controle nemen (zoals de RouteServiceProvider in Laravel 10):Geef je using op, dan wordt de standaard routeregistratie van Laravel volledig uitgeschakeld en beheer je alles zelf.

->withRouting(
    using: function () {
        Route::middleware('web')
            ->group(base_path('routes/web.php'));

        Route::middleware('api')
            ->prefix('api')
            ->group(base_path('routes/api.php'));
    },
)

Ik wil een standaard ServiceProvider van Laravel vervangen

Voeg je een providers-sleutel toe aan config/app.php, dan wordt die samengevoegd met de config/app.php binnen het framework en toegepast.

// config/app.php
use Illuminate\Support\ServiceProvider;

return [
    // ...
    'providers' => ServiceProvider::defaultProviders()->replace([
        Illuminate\Foo\FooServiceProvider::class => Bar\BarServiceProvider::class,
    ])->toArray(),
];

Met de replace()-methode vervang je een standaardprovider door je eigen implementatie.

routes/api.php ontbreekt

Vanaf Laravel 11 is API-functionaliteit niet standaard aanwezig; je installeert die apart wanneer je die nodig hebt.

php artisan install:api

Dit commando maakt en configureert het volgende:

routes/api.php
De configuratie van Laravel Sanctum voor API-authenticatie
Registratie van de API-routes in bootstrap/app.php

routes/channels.php ontbreekt

Vanaf Laravel 11 is ook broadcastingfunctionaliteit niet standaard aanwezig; je installeert die apart wanneer je die nodig hebt.

php artisan install:broadcasting

Dit commando maakt en configureert het volgende:

routes/channels.php
De installatie en configuratie van Laravel Reverb
Het configuratiebestand voor broadcasting

Ik wil weten of een project waar ik instap de oude of nieuwe structuur gebruikt

Bekijk de inhoud van bootstrap/app.php.Nieuwe structuur van Laravel 11 en later (of al gemigreerd):

// bootstrap/app.php
return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(...)
    ->withMiddleware(...)
    ->withExceptions(...)
    ->create();

Project dat met de oude structuur van Laravel 10 of eerder is geüpgraded:

// bootstrap/app.php
$app = new Illuminate\Foundation\Application(
    $_ENV['APP_BASE_PATH'] ?? dirname(__DIR__)
);

$app->singleton(
    Illuminate\Contracts\Http\Kernel::class,
    App\Http\Kernel::class
);
// ...

Zie je de vorm return Application::configure(..., dan is het de nieuwe structuur; zo niet, dan is het een project dat met de oude structuur is geüpgraded. Voor het migreren van een project met de oude structuur naar de nieuwe structuur, zie de migratiegids.

AI-ontwikkeling

Design patterns

Package-ontwikkeling

Applicatiestructuur

Nieuwe functies in Laravel 13

Eloquent in detail

Validatie-uitbreidingen

Authenticatie uitbreiden

Beveiliging

Queues

Testen

FAQ over de nieuwe appstructuur van Laravel 11+

Gerelateerde pagina’s

Applicatiestructuur van Laravel 11 en later

Migratiegids van oude naar nieuwe structuur

​Gerelateerde pagina’s

Applicatiestructuur van Laravel 11 en later

Migratiegids van oude naar nieuwe structuur

Gerelateerde pagina’s