Deze handleiding geldt voor Laravel 10 of 11 en PHP 8.1 of hoger. Voorwaarden zijn een live24h account, een workspace en een API key met schrijfrechten – zie gemeenschappelijke stappen .
Installeren
Het package is een Composer-package met auto-discovery – de ServiceProvider wordt automatisch ingebonden:
composer require live24h/laravel-adapter
php artisan vendor:publish --provider="Live24h\LaravelAdapter\LaravelServiceProvider"
Het tweede command publiceert de configuratie config/live24h.php. Vul daar api_key en api_base_url in (standaard https://api.live24h.eu) – of voer de key later op de settings-pagina in. Het package wordt via directe download van live24h verkregen; een marktplaats-vermelding volgt.
Stap voor stap
Het package stelt een auth-gegate route-group beschikbaar (middleware: web, auth): het Health Center onder /live24h/health, een settings-pagina en de setup-wizard. Het geïllustreerde verloop staat in het overzicht
; de stappen voor Laravel zijn:
- Open als aangemelde gebruiker
/live24h/health. - Controleer op de settings-pagina de verbinding („Verbinding testen"). De API key wordt steeds gemaskeerd weergegeven.
- Start de analyse van de app.
- Bekijk de Website Health Score en de aanbevelingen.
- Selecteer de checks – vergrendelde voorstellen blijven zichtbaar en zijn als „Vanaf Pro" gemarkeerd.
- Leg de checks met één klik aan.
De scan dekt vier gebieden af: SEO (robots.txt, sitemap), SSL/domein/DNS (TLS-certificaat, apex-domein), mail-bezorgbaarheid (MX, SPF, DKIM, DMARC van het afzenderdomein uit de MAIL_*-configuratie) en achtergrondverwerking (Scheduler schedule:run en queue-workers als heartbeat).
Policy-presets voor rollouts
Voor meerdere apps zijn er drie voorinstellingen die de omvang van de aangelegde checks bepalen:
- essential – alleen de belangrijkste checks (bereikbaarheid, SSL).
- recommended – de standaard inclusief SEO, domein en mail-DNS.
- all – bovendien de Scheduler- en queue-heartbeats.
Zo brengt u dezelfde monitoring-standaard reproduceerbaar in elk Laravel-project.
Probleemoplossingen en tips
De route /live24h/health is niet bereikbaar.
De route-group gebruikt de middleware web en auth – u moet dus aangemeld zijn. Controleer bovendien of de configuratie gepubliceerd is (php artisan vendor:publish) en leeg indien nodig de cache met php artisan config:clear en php artisan route:clear.
„Verbinding testen" mislukt.
Controleer api_key (schrijfrechten vereist), api_base_url (https://api.live24h.eu) en of de server uitgaand naar buiten mag verbinden.
Het verkeerde of geen mail-domein wordt gecontroleerd.
Het afzenderdomein wordt afgeleid uit de MAIL_*-configuratie. Stel MAIL_FROM_ADDRESS correct in, zodat MX, SPF, DKIM en DMARC van het juiste domein worden gecontroleerd.
Een heartbeat-check blijft op „Wachtend". Dat is normaal en geen fout: een heartbeat wacht op het eerste signaal van het bewaakte proces (de ping naar de heartbeat-URL). Zolang de Scheduler-run of de queue-worker zich nog niet heeft gemeld, staat de check op „Wachtend" – niet op „Storing". Bij de eerste run wisselt de status naar „Operationeel".
De Scheduler-heartbeat meldt zich niet.
Zorg ervoor dat php artisan schedule:run daadwerkelijk elke minuut via cron wordt uitgevoerd en dat de queue-worker (php artisan queue:work) draait. Zonder lopend proces blijft de bijbehorende heartbeat op „Wachtend".
Veelgestelde vragen
Moet ik routes handmatig invoeren? Nee. De scan leidt de relevante checks af uit de app – SEO, SSL/domein, mail-DNS alsook Scheduler- en queue-heartbeats. U selecteert alleen nog en legt met één klik aan.
Wordt er iets in mijn app gemeten of opgeslagen? Het package scant lezend en legt checks aan. De lopende 24/7-controles neemt daarna het live24h platform over – het package zelf is geen monitoring-engine.
Is het geschikt voor meerdere apps?
Ja. Met de policy-presets essential, recommended en all laat dezelfde monitoring-standaard zich reproduceerbaar over alle Laravel-apps uitrollen.