De package
Aanmelden met Exact is het stuk dat in elk project terugkomt, en het is ook het stuk dat je geen twee keer wil schrijven. Het staat op Packagist als hansdeboeck/socialite-exactonline: een provider voor Laravel Socialite, zodat Exact Online dezelfde weg volgt als Google of Microsoft.
Installeren, en de gegevens van je app bij Exact in config/services.php zetten:
composer require hansdeboeck/socialite-exactonline:dev-master
'exactonline' => ['client_id' => env('EXACTONLINE_CLIENT_ID'),'client_secret' => env('EXACTONLINE_CLIENT_SECRET'),'redirect' => env('EXACTONLINE_CALLBACK_URL'),'base_url' => env('EXACTONLINE_BASE_URL', 'https://start.exactonline.be'),],
Daarna is aanmelden een regel, en komt de gebruiker terug met zijn naam, zijn mailadres en zijn foto, plus het token en de verversing waarmee de rest van de api aangesproken wordt:
return Socialite::driver('exactonline')->redirect();
Wat ze doet is smal gehouden: het adres van de toestemming en van het token, het token ophalen, en de aangemelde gebruiker uitlezen. Meer niet. Het verversen, de administratie onthouden, de boekingen: dat is werk van de applicatie erboven. Een provider die meer doet dan aanmelden, is een provider die in de weg gaat zitten zodra een project iets anders wil.
Het land is wel instelbaar, want dat is het enige dat aan de provider zelf hangt: base_url staat standaard op het Belgische adres en gaat met een regel in je .env naar het Nederlandse of het Duitse.
Ze is de oudste van mijn reeks, en de enige die niet van nul begon. Ik nam in 2021 een bestaande provider over die was blijven liggen, zette hem op Socialite Providers 4 en op een recente PHP, en bracht hem onder mijn eigen naam op Packagist omdat er projecten op draaiden. De tag die er staat, is nog die van voor die overname: voor PHP 8 neem je dus dev-master, zoals hierboven. De broncode staat op GitHub, onder MIT.