Laravel debugbar – jedna z najczęściej używanych bibliotek Laravela
29-01-2024
Laravel, jedna z najpopularniejszych platform do tworzenia aplikacji webowych w języku PHP, zyskała ogromną popularność dzięki swojej prostocie, elastyczności i rozbudowanym funkcjom. Jednak, jak każda technologia, także Laravel nie jest pozbawiony wyzwań związanych z debugowaniem i monitorowaniem aplikacji. W tym kontekście, Laravel Debugbar wchodzi na scenę jako nieocenione narzędzie, które ułatwia programistom śledzenie wykonywania kodu, analizowanie zapytań do bazy danych, oraz monitorowanie wydajności aplikacji.
Spis treści
Czym jest Laravel debugbar?
Laravel debugbar to pasek zawierający narzędzia do monitorowania działania aplikacji napisanej w Laravelu. Za jego pomocą możesz monitorować wykonywane zapytania, wyjątki, i inne kluczowe kwestie związane z wydajnością naszej aplikacji.
Laravel debugbar został zaprojektowany w celu uproszczenia procesu debugowania i zwiększenia produktywności. Dzięki niemu łatwiej jest wykryć i rozwiązać problemy w projektach tworzonych w Laravelu.
Kluczowe funkcjonalności Laravel debugbar

Inspekcja Zapytań SQL i Eloquent ORM:
Laravel Debugbar umożliwia szybkie sprawdzenie i analizę wykonanych zapytań do bazy danych oraz ich rezultatów, umożliwiając monitorowanie wydajności modeli Eloquent. Dzięki temu możesz skutecznie optymalizować działanie Twojej aplikacji, zidentyfikować ewentualne problemy z zapytaniami do bazy danych i zoptymalizować je.
Profilowanie Żądań:
Debugbar śledzi i prezentuje szczegółowe informacje dotyczące każdego żądania HTTP, obejmujące czas wykonania, użycie pamięci oraz chronologię zdarzeń. To narzędzie pomaga w identyfikacji potencjalnych problemów z wydajnością, ułatwiając zoptymalizowanie kodu.
Logowanie i Wyjątki:
Dedykowany panel Debugbara umożliwia przeglądanie i analizę komunikatów logów oraz wyjątków, które wystąpiły podczas działania Twojej aplikacji. To ułatwia proces debugowania i rozwiązywania problemów związanych z błędami.
Pomiar Czasu i Testowanie Wydajności:
Debugbar umożliwia pomiar czasu wykonania określonych fragmentów kodu, co pozwala zidentyfikować obszary, które mogą wymagać optymalizacji. Funkcja benchmarkingu pozwala na bieżąco monitorować i analizować wydajność aplikacji.
Dostosowywanie i Rozszerzanie:
Oferuje elastyczność w zakresie dostosowywania i rozszerzania, umożliwiając dodawanie niestandardowych paneli do debugowania oraz integrację dodatkowych funkcji dostosowanych do konkretnych potrzeb debugowania.
Laravel Debugbar to kompleksowe narzędzie, które nie tylko ułatwia proces debugowania, ale także zapewnia bogate informacje diagnostyczne, przyspieszając rozwój aplikacji opartych na Laravelu. Dzięki tym funkcjom, programiści mogą skupić się na doskonaleniu kodu i zoptymalizowaniu wydajności swoich projektów.
Instalacja
Aby włączyć bibliotekę w swoim projekcie Laravel, możesz skorzystać z narzędzia Composer. Zaleca się dodawanie pakietu tylko do środowiska developerskiego, aby uniknąć wpływu na środowisko produkcyjne. Użyj poniższej komendy Composer, aby zainstalować pakiet:
composer require barryvdh/laravel-debugbar --dev
Żeby móc korzystać z Laravel debugbar, należy dodać do tablicy providers w config/app.php:
Barryvdh\Debugbar\ServiceProvider::class,
Warto też w tym samym pliku dodać odpowiedni alias
'Debugbar' => Barryvdh\Debugbar\Facades\Debugbar::class,
Dodatkową konfigurację Laravel debugbar znajdziesz w pliku config/debugbar.php. Możesz tam zarówno wykluczyć, jak i dodać funkcjonalności do Twojego paska, które są dla Ciebie istotne. Domyślna konfiguracja jest całkiem w porządku, a wszystkie funkcjonalności opisane, więc nie będę tym tematem się zajmować w tym miejscu.
Skopiuj konfigurację pakietu do lokalnej konfiguracji za pomocą polecenia publish:
php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"
Jak używać Laravel debugbar?
Jeśli wykonałeś powyższe kroki, debugbar powinien już działać na stronie. Zazwyczaj pierwszą zakładką będzie messages. Własne wiadomości możesz umieszczać wewnątrz kodu. Mogą zawierać zarówno jakieś komunikataty, wartości zmiennych, obiekty, czy kolekcje. Przykłady użycia pokazuję poniżej. Często może to być świetny zamiennik, np. dd(), kiedy chcesz wyświetlić wartości, które siedzą w jakiejś zmiennej, a jednocześnie chcesz, żeby strona wyświetliła się poprawnie.
\Debugbar::info($obiekt);
\Debugbar::error('Błąd!');
\Debugbar::warning('Ostrzenie');
\Debugbar::addMessage('Inna wiadomość', 'Hello World');
Nie będę tutaj opisywał wszystkich funkcjonalności, ponieważ można je sobie przeklikać. Zwrócę uwagę tylko na najciekawsze, moim zdaniem:
podstawowe informacje – na belce znajdziemy podstawowe informacje, jak routing, wersja PHP, użycie pamięci, itp. Co istotne – w zaznaczonym na screenie miejscu możesz sobie wybrać konkretny request, który chcesz debugować.

Models – wskazuje modele jakie zostały użyte w danym miejscu. Innymi słowy, jeśli uruchamiasz widok, w którym wyświetlasz dane z modelu User i Article, to zakładka ta wskaże dwa modele.
Queries – kolejna bardzo ważna zakładka, która pozwala nie tylko sprawdzić jak dokładnie wygląda zapytanie, które wykonujesz, ale także ile zabiera czasu.

Exceptions – wyświetlane są wyjątki.
Messages – jak wspomniałem wcześniej, możemy tutaj wyświetlić, np, zawartość jakieś zmiennej, zamiast korzystać z dd().
Możesz włączać lub wyłączać Debugbar w trakcie działania.
\Debugbar::enable();
\Debugbar::disable();
Laravel debugbar – podsumowanie
Nie bez powodu Laravel debugbar jest jednym z najczęściej używanych bibliotek do Laravela. Pozwala w prosty sposób, wizualnie debugować kod, a także optymalizować go i poprawiać jego wydajność. Mam nadzieję, ze ten krótki poradnik zachęcił Ciebie do korzystania z tego narzędzia.