Laravel Folio

Introductie

Laravel Folio is een paginagebaseerde router waarmee je routes definieert door simpelweg Blade-bestanden te plaatsen. Anders dan de traditionele definitie via routes/web.php, wordt de structuur van het bestandssysteem rechtstreeks weerspiegeld in de URL’s. Folio is vooral handig voor contentgerichte sites en beheerpanelen waar je snel pagina’s per scherm wilt toevoegen. Voor onderdelen die fijnmazige HTTP-controle vereisen, zoals API’s, is het praktischer om Folio te combineren met gewone routing.

Installatie

Voeg Folio eerst toe via Composer.

composer require laravel/folio
php artisan folio:install

folio:install registreert de serviceprovider van Folio. Standaard is resources/views/pages/ de paginadirectory. Wil je meerdere paginadirectories of verschillende basis-URI’s gebruiken, dan stel je in de boot-methode van de serviceprovider Folio::path() en uri() in.

use Laravel\Folio\Folio;

Folio::path(resource_path('views/pages/guest'))->uri('/');

Folio::path(resource_path('views/pages/admin'))
    ->uri('/admin');

Routes maken

Folio genereert automatisch URL’s op basis van de Blade-bestandsnamen in de gemounte directory.

resources/views/pages/schedule.blade.php -> /schedule

php artisan folio:list

Geneste routes

Als je directories nest, worden de URL’s met dezelfde structuur genest.

php artisan folio:page user/profile
# pages/user/profile.blade.php -> /user/profile

Indexroutes

index.blade.php wordt gemapt op de root van de betreffende directory.

php artisan folio:page index
# pages/index.blade.php -> /

php artisan folio:page users/index
# pages/users/index.blade.php -> /users

Routeparameters

Met [] in de bestandsnaam kun je URL-segmenten ontvangen.

php artisan folio:page "users/[id]"
# pages/users/[id].blade.php -> /users/1

<div>User {{ $id }}</div>

Wil je meerdere segmenten ontvangen, gebruik dan ....

php artisan folio:page "users/[...ids]"
# pages/users/[...ids].blade.php -> /users/1/2/3

@foreach ($ids as $id)
    <li>User {{ $id }}</li>
@endforeach

Route model binding

Gebruik je een modelnaam zoals in [User].blade.php, dan wordt het model automatisch opgelost.

php artisan folio:page "users/[User]"
# pages/users/[User].blade.php -> /users/1

<div>User {{ $user->id }}</div>

Wil je ook soft-deleted modellen ophalen, roep dan withTrashed() aan binnen de pagina.

<?php

use function Laravel\Folio\withTrashed;

withTrashed();

Schrijf je [Post:slug].blade.php, dan kun je het model ook oplossen op een andere sleutel dan id (bijvoorbeeld slug).

Middleware

Wil je middleware alleen op een specifieke pagina toepassen, gebruik dan middleware() binnen de paginatemplate.

<?php

use function Laravel\Folio\middleware;

middleware(['auth', 'verified']);

Wil je middleware in één keer op meerdere pagina’s toepassen, gebruik dan Folio::path(...)->middleware().

<?php

use Laravel\Folio\Folio;

Folio::path(resource_path('views/pages'))->middleware([
    'admin/*' => ['auth', 'verified'],
]);

Benoemde routes

Ook Folio-pagina’s kun je met name() een routenaam geven.

<?php

use function Laravel\Folio\name;

name('users.index');

Definieer je op een individuele pagina zoals users/[User].blade.php de naam name('users.show'), dan kun je URL’s met parameters genereren via route('users.show', ['user' => $user]).

Met de toegekende routenaam kun je via de route()-helper URL’s genereren.

route('users.index');
route('users.show', ['user' => $user]);

Overeenkomst tussen bestanden en URL’s

Vergelijking met traditionele routing

Kenmerk	Gewone routing	Folio
Routedefinitie	`routes/web.php`	Automatisch via bestandsnaam
Controller	Nodig (of een closure)	Niet nodig (rechtstreeks in Blade)
Geschikt voor	API’s, SPA’s, complexe HTTP-controle	Contentsites, beheerpanelen

Ook als je Folio gebruikt, kun je met php artisan route:cache de routecache inschakelen om de productieprestaties te optimaliseren.

Architectuur

Database

Eloquent

Beveiliging

Events

E-mail en notificaties

Betalingen

Asynchrone verwerking

Realtime communicatie

Taakplanning

Caching en optimalisatie

Internationalisatie

Bestanden en opslag

Debugging en monitoring

Console en CLI

Performance

Frontend

AI-ontwikkeling

Ontwikkelomgeving

Introductie

Installatie

Routes maken

Geneste routes

Indexroutes

Routeparameters

Route model binding

Middleware

Benoemde routes

Overeenkomst tussen bestanden en URL’s

Vergelijking met traditionele routing

​Introductie

​Installatie

​Routes maken

​Geneste routes

​Indexroutes

​Routeparameters

​Route model binding

​Middleware

​Benoemde routes

​Overeenkomst tussen bestanden en URL’s

​Vergelijking met traditionele routing

Introductie

Installatie

Routes maken

Geneste routes

Indexroutes

Routeparameters

Route model binding

Middleware

Benoemde routes

Overeenkomst tussen bestanden en URL’s

Vergelijking met traditionele routing