Ta instrukcja dotyczy Laravel 10 lub 11 oraz PHP 8.1 lub wyższego. Wymagane są konto live24h, Workspace i API key z prawem zapisu – zobacz wspólne kroki .
Instalacja
Pakiet to pakiet Composer z Auto-Discovery – ServiceProvider jest dołączany automatycznie:
composer require live24h/laravel-adapter
php artisan vendor:publish --provider="Live24h\LaravelAdapter\LaravelServiceProvider"
Druga komenda publikuje konfigurację config/live24h.php. Wprowadź tam api_key i api_base_url (domyślnie https://api.live24h.eu) – albo wpisz key później na stronie ustawień. Pakiet jest dostępny przez bezpośredni download z live24h, wpis na marketplace pojawi się wkrótce.
Krok po kroku
Pakiet udostępnia grupę tras zabezpieczoną auth (middleware: web, auth): Health Center pod /live24h/health, stronę ustawień i kreator konfiguracji. Zilustrowany przebieg jest przedstawiony w przeglądzie
; kroki dla Laravel to:
- Otwórz jako zalogowany użytkownik
/live24h/health. - Sprawdź na stronie ustawień połączenie („test połączenia"). API key jest zawsze wyświetlany zamaskowany.
- Uruchom analizę aplikacji.
- Obejrzyj Website Health Score i rekomendacje.
- Wybierz checki – zablokowane propozycje pozostają widoczne i są oznaczone jako „Od Pro".
- Załóż checki jednym kliknięciem.
Skan obejmuje cztery obszary: SEO (robots.txt, Sitemap), SSL/domena/DNS (certyfikat TLS, domena Apex), dostarczalność poczty (MX, SPF, DKIM, DMARC domeny nadawcy z konfiguracji MAIL_*) oraz przetwarzanie w tle (Scheduler schedule:run i worker Queue jako heartbeat).
Presety polityki dla rolloutów
Dla wielu aplikacji istnieją trzy ustawienia wstępne określające zakres zakładanych checków:
- essential – tylko najważniejsze checki (dostępność, SSL).
- recommended – standard wraz z SEO, domeną i Mail-DNS.
- all – dodatkowo heartbeaty Scheduler i Queue.
Tak wprowadzasz ten sam standard monitoringu powtarzalnie do każdego projektu Laravel.
Rozwiązywanie problemów i wskazówki
Trasa /live24h/health jest niedostępna.
Grupa tras korzysta z middleware web i auth – musisz więc być zalogowany. Sprawdź ponadto, czy konfiguracja została opublikowana (php artisan vendor:publish), i w razie potrzeby wyczyść cache przez php artisan config:clear oraz php artisan route:clear.
„Test połączenia" kończy się błędem.
Sprawdź api_key (wymagane prawo zapisu), api_base_url (https://api.live24h.eu) oraz to, czy serwer może nawiązywać połączenia wychodzące na zewnątrz.
Sprawdzana jest niewłaściwa domena poczty lub żadna.
Domena nadawcy jest wyprowadzana z konfiguracji MAIL_*. Ustaw poprawnie MAIL_FROM_ADDRESS, aby MX, SPF, DKIM i DMARC były sprawdzane dla właściwej domeny.
Check heartbeat pozostaje na „Oczekuje". To normalne i nie jest błędem: heartbeat czeka na pierwszy sygnał monitorowanego procesu (ping pod adres URL heartbeatu). Dopóki przebieg Scheduler lub worker Queue jeszcze się nie zgłosił, check pozostaje na „Oczekuje" – nie na „Awaria". Po pierwszym przebiegu status zmienia się na „Operacyjny".
Heartbeat Scheduler się nie zgłasza.
Upewnij się, że php artisan schedule:run jest rzeczywiście uruchamiane co minutę przez Cron, a worker Queue (php artisan queue:work) działa. Bez działającego procesu powiązany heartbeat pozostaje na „Oczekuje".
Najczęstsze pytania
Czy muszę ręcznie wpisywać trasy? Nie. Skan wyprowadza istotne checki z aplikacji – SEO, SSL/domena, Mail-DNS oraz heartbeaty Scheduler i Queue. Pozostaje Ci tylko wybór i założenie jednym kliknięciem.
Czy coś jest mierzone lub zapisywane w mojej aplikacji? Pakiet skanuje czytająco i zakłada checki. Działające kontrole 24/7 przejmuje następnie platforma live24h – sam pakiet nie jest silnikiem monitoringu.
Czy nadaje się do wielu aplikacji?
Tak. Za pomocą presetów polityki essential, recommended i all ten sam standard monitoringu można powtarzalnie rozprowadzić na wszystkie aplikacje Laravel.