Jak uruchomić tryb debugowania PrestaShop?

Każdy sklep internetowy oparty na PrestaShop prędzej czy później wymaga diagnostyki błędów. Czasami pojawia się pusta strona, innym razem komunikat o błędzie 500, a bywa, że konkretna funkcja przestaje działać poprawnie. W takich sytuacjach z pomocą przychodzi tryb debugowania PrestaShop. To narzędzie, które nie jest przeznaczone dla zwykłych klientów odwiedzających sklep, ale dla Ciebie – administratora, programisty czy specjalisty technicznego.

Co to jest tryb debugowania w PrestaShop?

Tryb debugowania w PrestaShop to specjalna funkcjonalność diagnostyczna, umożliwiająca analizę błędów, które normalnie pozostają ukryte. W standardowym działaniu, gdy w sklepie wystąpi problem, użytkownik zobaczy pustą stronę lub komunikat błędu 500. To nie daje żadnej wartościowej informacji. Debugowanie zmienia sytuację.

W trybie debug:

• błędy wyświetlane są bezpośrednio w przeglądarce;
• możesz śledzić wywołania funkcji i prześledzić logikę działania sklepu;
• zyskujesz dostęp do szczegółowych informacji na temat problemów z bazą danych, plikami czy modułami;
• widzisz ostrzeżenia związane z wydajnością lub niepoprawnym kodem.

PrestaShop domyślnie ma wyłączony tryb debugowania. To rozwiązanie logiczne – w sklepie widocznym dla klientów nie powinny pojawiać się żadne techniczne komunikaty. Ich publiczne udostępnianie mogłoby zdradzać wewnętrzne szczegóły działania sklepu. Dopiero w momencie diagnozy warto przejść do trybu debugowania i zebrać wszystkie potrzebne informacje.

Jak działa tryb debugowania w PrestaShop?

Włączenie trybu debugowania aktywuje specjalne mechanizmy w kodzie PrestaShop. System PHP, na którym opiera się PrestaShop, przestaje ukrywać błędy i zaczyna wyświetlać je w pełnej formie.

W praktyce oznacza to:

• zamiast pustej strony zobaczysz dokładną treść błędu;
• pojawi się ścieżka do pliku, w którym wystąpił problem;
• komunikaty wskażą linijkę kodu powodującą przerwanie działania;
• możesz sprawdzić zapytania SQL kierowane do bazy danych i błędy w ich wykonaniu.

Debugowanie nie ogranicza się tylko do kodu PHP. W trybie debugowania w PrestaShop możesz także analizować działanie szablonu, modułów oraz wszelkich niestandardowych rozszerzeń. Dla programistów to bezcenne źródło informacji.

Zapamiętaj!

Włączanie trybu debug w sklepie PrestaShop ma bezpośredni wpływ na wydajność. Sklep zaczyna działać wolniej, ponieważ każdy proces jest dokładniej monitorowany. Dlatego debugowanie włącza się tylko wtedy, gdy jest potrzebne, a po dokonaniu zmian i rozwiązaniu problemu trzeba je wyłączyć.

Jak włączyć tryb debugowania w PrestaShop za pomocą panelu administracyjnego i pliku defines.inc.php?

Istnieją dwa sposoby, aby włączyć tryb debugowania w PrestaShop. Pierwszy – prostszy – odbywa się z poziomu panelu administracyjnego PrestaShop. Drugi – bardziej techniczny – wymaga edycji pliku konfiguracyjnego defines.inc.php znajdującego się w katalogu config.

Włączanie trybu debug z panelu administracyjnego PrestaShop

1. Zaloguj się do panelu administracyjnego.
2. Przejdź do zakładki Zaawansowane → Wydajność.
3. W sekcji „Tryb debugowania” znajdziesz opcję „Włącz tryb debugowania”.
4. Zaznacz opcję i kliknij Zapisz zmiany.

Od tego momentu, w przypadku błędów, zamiast pustej strony zobaczysz szczegółowe komunikaty wyświetlane bezpośrednio w przeglądarce.

Włączenie trybu debugowania poprzez edycję pliku defines.inc.php

Jeśli nie masz dostępu do panelu administracyjnego (np. sklep wyświetla pustą stronę), trzeba skorzystać z drugiej metody.

• Połącz się z serwerem przez FTP lub menedżera plików w panelu hostingowym.
• Przejdź do katalogu config.
• Otwórz plik defines.inc.php.
• Znajdź linię:

Zdj 1. Fragment pliku defines.inc.php – tryb debug wyłączony.

• Zmień wartość false na true, aby włączyć tryb debugowania:

Zdj 2. Ten sam plik po zmianie – tryb debug włączony.

• Po dokonaniu zmian zapisz plik i zamknij edytor.

Od tej chwili debugowanie jest aktywne. Wszystkie błędy będą widoczne w przeglądarce, a Ty możesz rozpocząć ich analizę.

Kiedy wybrać która metodę?

• panel administracyjny PrestaShop sprawdzi się wtedy, gdy masz pełny dostęp do zaplecza i sklep działa na tyle stabilnie, że można się do niego zalogować;
• edycja pliku defines.inc.php jest konieczna, gdy sklep pokazuje pustą stronę lub uniemożliwia logowanie.

Obie metody działają identycznie – końcowym efektem jest aktywacja trybu debugowania i pełne komunikaty błędów.

Jak odpalić w PrestaShop 1.7 tryb debugowania?

Wersja PrestaShop 1.7 wprowadziła kilka zmian w interfejsie panelu administracyjnego, jednak sposób włączania trybu debug pozostaje bardzo zbliżony.

W PrestaShop 1.7 debugowanie można uruchomić:

• poprzez panel administracyjny, wchodząc w zakładkę zaawansowane → wydajność i wybierając opcję „włącz tryb debugowania”;
• poprzez edycję pliku defines.inc.php, zmieniając wartość define(’_PS_MODE_DEV_’, true).

Warto pamiętać, że w PrestaShop 1.7 debugowanie jest jeszcze bardziej szczegółowe. System wyświetla nie tylko błędy PHP, ale także szczegółowe informacje dotyczące klas, szablonów, a nawet działania modułów. Dzięki temu zyskujesz pełną kontrolę nad procesami zachodzącymi w sklepie.

Jeśli w sklepie PrestaShop 1.7 napotkasz pustą stronę, to pierwszym krokiem powinna być właśnie aktywacja trybu debugowania.

Jak odpalić w PrestaShop 1.6 tryb debugowania?

PrestaShop 1.6 różni się pod względem wyglądu panelu administracyjnego od wersji 1.7, ale logika debugowania jest podobna. W tej odsłonie systemu włączenie trybu debug również można wykonać dwiema metodami: przez panel administracyjny lub poprzez edycję pliku defines.inc.php na serwerze.

Włączanie trybu debug w panelu administracyjnym PrestaShop 1.6

1. Zaloguj się do panelu administracyjnego.
2. Przejdź do zakładki Zaawansowane → Wydajność.
3. Zjedź niżej do sekcji Tryb debugowania.
4. Wybierz opcję „Włącz tryb debugowania”.
5. Kliknij przycisk Zapisz zmiany.

Od razu po dokonaniu zmian wszystkie błędy w sklepie będą wyświetlane bezpośrednio w przeglądarce.

Włączanie debugowania przez edycję pliku w PrestaShop 1.6

• Wejdź na serwer poprzez FTP albo menedżera plików.
• Odnajdź katalog config.
• Otwórz plik defines.inc.php.
• Wyszukaj linię:

Zdj 3. Ponowne ustawienie wartości false, czyli powrót do normalnego trybu.

• Zamień false na true.

Po zapisaniu pliku i zamknięciu edytora debugowanie zostanie uruchomione.

Różnice między PrestaShop 1.6 a PrestaShop 1.7

Jak wyłączyć tryb debugowania w PrestaShop?

Po rozwiązaniu problemu tryb debugowania trzeba wyłączyć. Pozostawienie go aktywnego w sklepie produkcyjnym jest błędem. 

Powody są dwa:

1. Wydajność – włączony tryb debug spowalnia działanie sklepu, ponieważ system wykonuje dodatkowe operacje diagnostyczne. Klient odczuje dłuższe ładowanie podstron.
2. Bezpieczeństwo – komunikaty wyświetlane bezpośrednio mogą zdradzać informacje o strukturze sklepu, bazie danych, katalogu czy plikach. To ryzyko, którego nie warto podejmować.

Wyłączanie trybu debug przez panel administracyjny

• Wejdź do panelu administracyjnego.
• Przejdź do zakładki Zaawansowane → Wydajność.
• W sekcji „Tryb debugowania” odznacz opcję.
• Kliknij Zapisz zmiany.

Wyłączanie debugowania poprzez plik defines.inc.php

• Otwórz plik config/defines.inc.php.
• Zmień wartość true na false:

Zdj 4. Kolejny przykład wyłączenia trybu debugowania w konfiguracji.

• Po zapisaniu pliku tryb debugowania zostanie wyłączony.

Zawsze pamiętaj, że debugowanie służy jedynie do czasowej diagnostyki i musi zostać wyłączone po dokonaniu zmian.

Jak interpretować komunikaty błędów wyświetlane w trybie debugowania?

Kiedy tryb debugowania w PrestaShop jest aktywny, na ekranie pojawiają się rozbudowane komunikaty. Ich analiza wymaga spokoju i skupienia.

Typowe elementy komunikatu błędu:

• Rodzaj błędu – np. Fatal error, Parse error, Warning;
• Ścieżka pliku – dokładne wskazanie katalogu i pliku, w którym wystąpił błąd;
• Linia kodu – numer linii, gdzie system przerwał wykonywanie;
• Opis błędu – np. „Call to undefined function” czy „Undefined index”.

Na tej podstawie możesz dojść do źródła problemu. Jeśli widzisz błąd związany z modułem, wystarczy wejść do katalogu modules i odszukać wskazany plik. W przypadku błędów SQL komunikat pokaże zapytanie, które spowodowało problem w bazie danych.

Nie każdy komunikat oznacza poważną awarię. Często pojawiają się ostrzeżenia (Warning) – sygnalizują one problemy z kompatybilnością kodu, ale nie zawsze blokują działanie sklepu.

Przykłady interpretacji:

• jeśli komunikat wskazuje na brak klasy lub funkcji w module – prawdopodobnie instalacja modułu nie została zakończona poprawnie;
• błąd typu „Undefined index” oznacza, że kod próbuje odwołać się do elementu tablicy, który nie istnieje;
• komunikaty SQL podpowiadają, czy problem dotyczy struktury bazy danych, np. brak kolumny lub błędne zapytanie.

Debugowanie ułatwia szybkie znalezienie przyczyny, zamiast błądzenia po omacku w katalogach i plikach.

Jak naprawić błąd 500 po włączeniu trybu debugowania?

Błąd 500 to najczęstszy problem w sklepach PrestaShop. W normalnym trybie widzisz jedynie „Internal Server Error”, co nie daje żadnych wskazówek. Włączenie debugowania zmienia sytuację – komunikat ujawnia dokładną przyczynę.

Najczęstsze powody błędu 500:

• błędny kod w module lub szablonie;
• niekompletna aktualizacja sklepu;
• uszkodzony plik PHP;
• problemy z zapytaniami SQL w bazie danych;
• niezgodność wersji PHP na serwerze.

Postępowanie krok po kroku:

• Włącz tryb debugowania.
• Sprawdź, co komunikat wyświetla bezpośrednio.
• Zanotuj plik, katalog i linię kodu wskazane w błędzie.
• Przejdź do tego miejsca i sprawdź zawartość.
• Jeśli problem wynika z modułu – wyłącz go w panelu lub usuń z katalogu modules.
• W przypadku problemów z bazą danych sprawdź strukturę tabel w panelu phpMyAdmin.

Dzięki debugowaniu masz jasne informacje, a naprawa błędu 500 nie jest już zgadywaniem.

Jak tryb debugowania wpływa na wydajność sklepu internetowego?

Kiedy włączasz tryb debug, system zaczyna rejestrować, analizować i wyświetlać szczegółowe dane o każdym błędzie, ostrzeżeniu czy konflikcie w kodzie. To nie dzieje się bez kosztów.

Spadek szybkości ładowania strony

Po uruchomieniu trybu debugowania zauważysz, że sklep ładuje się wolniej. 

Wynika to z faktu, że:

• PrestaShop wykonuje dodatkowe operacje monitorujące;
• generowane są rozbudowane komunikaty PHP;
• przy każdym żądaniu przeglądarka pobiera więcej treści diagnostycznych.

Dla klienta oznaczałoby to niekomfortowe korzystanie ze sklepu, dlatego debugowanie powinno działać tylko tymczasowo, w fazie testów lub podczas rozwiązywania problemu.

Wpływ na zasoby serwera

Tryb debugowania obciąża nie tylko przeglądarkę, ale także serwer. Przy większej liczbie odwiedzin i włączonym debugowaniu system:

• wykonuje więcej zapytań do bazy danych;
• zapisuje obszerne logi w plikach serwera;
• zajmuje dodatkową pamięć RAM podczas generowania komunikatów.

Jeżeli zostawisz tryb debug włączony na sklepie produkcyjnym, możesz zauważyć nie tylko spadek szybkości, ale i ryzyko przekroczenia limitów serwera.

Bezpieczeństwo a wydajność

Debugowanie nie ogranicza się do błędów technicznych – wyświetlane bezpośrednio komunikaty często zdradzają ścieżki katalogów, nazwy plików i fragmenty kodu. Te informacje, pozostawione publicznie, mogą ułatwić potencjalny atak na sklep. Dlatego debug zawsze trzeba wyłączyć po dokonaniu zmian.

Dobre praktyki korzystania z trybu debugowania

Tryb debugowania w PrestaShop powinien być narzędziem do szybkiej diagnostyki, a nie stałym elementem działania sklepu. Warto wdrożyć kilka praktyk, które ułatwiają pracę i minimalizują ryzyko.

Włączaj debug tylko w razie potrzeby

Nie zostawiaj go aktywnego na stałe. Po rozwiązaniu problemu przejdź do panelu administracyjnego lub pliku defines.inc.php i zmień wartość true na false.

Testuj na kopii sklepu

Najlepiej diagnozować błędy nie na sklepie produkcyjnym, ale na jego kopii umieszczonej w środowisku testowym. Wtedy możesz bezpiecznie uruchomić tryb debug, analizować dane i wprowadzać poprawki, bez narażania klientów na spadki wydajności.

Zbieraj logi

Komunikaty wyświetlane w przeglądarce są użyteczne, ale warto również zapisywać błędy w logach serwera. Pliki logów znajdziesz w katalogu serwera albo w panelu hostingowym. Dzięki nim możesz śledzić historię problemów i wrócić do wcześniejszych błędów nawet wtedy, gdy debugowanie było wyłączone.

Analizuj wersję PHP i moduły

Część problemów pojawia się nie z powodu samego PrestaShop, ale przez niezgodność wersji PHP lub błędy w zewnętrznych modułach. Tryb debug pomaga w ich identyfikacji, jednak pełne rozwiązanie wymaga czasem zmiany ustawień serwera albo aktualizacji modułów.

Praca z logami w trybie debugowania

Sama funkcja debugowania w PrestaShop to jedno, ale kluczowe znaczenie mają również logi zapisywane na serwerze. To uzupełniające źródło wiedzy.

• Logi błędów PHP – znajdziesz je w katalogu serwera lub w panelu administracyjnym hostingu. Informują o krytycznych błędach w kodzie.
• Logi serwera WWW – np. Apache lub Nginx, pozwalają sprawdzić błędy 404, problemy z dostępem do plików i katalogów.
• Logi PrestaShop – system posiada własny mechanizm rejestrowania błędów, dostępny w panelu administracyjnym w zakładce Zaawansowane → Logi.

Łącząc tryb debug z logami, uzyskujesz pełniejszy obraz sytuacji. Jeżeli w przeglądarce widzisz tylko fragment informacji, logi często dostarczą szczegółowych danych potrzebnych do rozwiązaniu problemu.

Rola hostingu i serwera w debugowaniu

Skuteczność debugowania zależy również od tego, jak skonfigurowany jest serwer.

Zasady:

1. Wersja PHP – PrestaShop 1.6 działa stabilnie na starszych wersjach PHP, natomiast PrestaShop 1.7 wymaga już PHP 7.1 i nowszych. Jeśli na serwerze aktywna jest niewłaściwa wersja, błędy będą częstsze.
2. Dostęp do plików – tryb debug wymaga edycji pliku defines.inc.php. Jeżeli nie masz dostępu do menedżera plików ani FTP, będziesz ograniczony tylko do panelu administracyjnego.
3. Pamięć serwera – komunikaty debugowania generują obciążenie. Na słabszym hostingu może to powodować przerwy w działaniu sklepu.

Dlatego debugowanie powinno zawsze iść w parze z kontrolą parametrów hostingu. Jeśli napotkasz powtarzające się problemy, warto przeanalizować, czy serwer jest odpowiednio dostosowany do wymagań sklepu PrestaShop.

Kiedy tryb debugowania jest absolutnie niezbędny?

Zdarzają się sytuacje, gdy bez debugowania nie wykonasz żadnego ruchu:

• pusta strona po instalacji modułu;
• błąd 500 po aktualizacji wersji PrestaShop;
• brak możliwości logowania do panelu administracyjnego;
• problemy z wywołaniami funkcji PHP;
• błędy SQL podczas pracy z bazą danych;
• niespodziewane przerwy w działaniu sklepu.

We wszystkich tych przypadkach debugowanie w PrestaShop daje Ci jasny komunikat, zamiast ogólnego błędu. To skraca czas diagnozy i umożliwia precyzyjne działanie.

Techniczne aspekty debugowania – define, true i false

Kiedy pracujesz z plikiem defines.inc.php, znaczenie mają trzy elementy:

• define – funkcja PHP używana do deklarowania stałych. W PrestaShop odpowiada za ustawienie trybu debugowania;
• true – aktywuje debugowanie, uruchamiając wyświetlanie błędów;
• false – wyłącza debugowanie, przywracając standardowy tryb ukrywania błędów.

Dzięki tej jednej linijce kodu w pliku konfiguracyjnym możesz przełączać się między trybem produkcyjnym a diagnostycznym. To podstawowa technika pracy w PrestaShop, znajomość której przydaje się każdemu administratorowi.

Jak interpretować i rozwiązywać typowe błędy w trybie debugowania

Kiedy już włączysz tryb debugowania w PrestaShop, pojawiają się konkretne komunikaty. Ich treść jest surowa, techniczna, ale to właśnie w niej znajdziesz rozwiązanie problemu. Warto poznać kilka najczęstszych scenariuszy.

Błąd typu ,,Fatal error”

Najbardziej krytyczny, zatrzymujący działanie całego sklepu. Komunikat zazwyczaj brzmi np.:

Zdj 5. Komunikat Fatal error – krytyczny błąd zatrzymujący działanie sklepu.

Interpretacja: w kodzie wywołano funkcję, której nie ma w danej wersji PHP lub której plik nie został załadowany. Rozwiązanie polega na sprawdzeniu pliku w katalogu modułu i uzupełnieniu brakującego fragmentu kodu albo aktualizacji modułu do nowszej wersji.

Błąd SQL – ,,Unknown column”

Często widoczny w trybie debug:

Zdj 6. Błąd SQL – brak kolumny id_customer w zapytaniu.

Interpretacja: w zapytaniu do bazy danych odwołujesz się do kolumny, której tabela nie posiada. Najczęściej jest to efekt przerwanej aktualizacji bazy. W takim przypadku trzeba porównać strukturę bazy z oficjalnym schematem PrestaShop i ręcznie uzupełnić brakujące kolumny.

Błąd ,,Undefined index”

To błąd ostrzegawczy:

Zdj 7. Ostrzeżenie typu Notice – brak indeksu cart w klasie koszyka.

Kod próbuje użyć tablicy, w której brakuje wskazanego elementu. Sklep działa, ale może występować niepoprawne zachowanie koszyka lub modułu. Rozwiązaniem jest sprawdzenie logiki modułu i dodanie warunku zabezpieczającego.

Błąd 500 po aktualizacji

W trybie debugowania dostajesz wtedy precyzyjny komunikat – np. konflikt między wersją PHP a PrestaShop. Często rozwiązaniem jest zmiana wersji PHP na serwerze, np. z 7.4 na 7.2, jeśli sklep działa na starszej wersji systemu.

Scenariusze pracy z trybem debugowania

Aby lepiej zrozumieć praktyczne wykorzystanie debugowania, przeanalizujmy kilka scenariuszy.

Instalacja nowego modułu

Po wgraniu modułu przez panel administracyjny sklep nagle przestaje działać i pokazuje pustą stronę.

• włączasz tryb debug;
• komunikat wskazuje plik w katalogu modules/nazwa_modulu;
• w kodzie okazuje się, że funkcja używa nieobsługiwanej wersji PHP;
• rozwiązaniem jest aktualizacja modułu albo poprawka w kodzie.

Aktualizacja sklepu do PrestaShop 1.7

Po przejściu z 1.6 na 1.7 sklep pokazuje błąd 500.

• tryb debug ujawnia, że problem leży w szablonie;
• szablon napisany pod 1.6 nie jest zgodny z nową strukturą;
• musisz zaktualizować szablon lub wybrać kompatybilną wersję.

Problemy z koszykiem

Klienci zgłaszają, że koszyk usuwa produkty.

• w trybie debug pojawia się ostrzeżenie „Undefined index: cart”;
• analiza pokazuje, że moduł płatności nadpisuje logikę koszyka;
• wyłączenie modułu i test potwierdzają źródło problemu;
• kontakt z autorem modułu daje poprawkę.

Takie scenariusze pokazują, że debugowanie jest fundamentem pracy administratora i programisty.

Wnioski

Jeżeli zarządzasz sklepem PrestaShop, prędzej czy później zetkniesz się z błędami. Czasem będzie to pusta strona, innym razem komunikat 500, a jeszcze innym problemy z modułami lub szablonami.

Bez debugowania naprawa takich błędów jest zgadywaniem. Z debugowaniem – dostajesz pełen zestaw narzędzi diagnostycznych. Widzisz, co dzieje się w kodzie, jakie zapytania idą do bazy danych, które pliki powodują awarię. To ogromna różnica.

Dlatego debugowanie powinno być Twoim pierwszym krokiem w rozwiązywaniu problemów. Włączasz tryb debug, analizujesz komunikaty, wprowadzasz poprawki, a następnie wyłączasz debugowanie i wracasz do standardowego trybu działania sklepu.

Tylko tyle i aż tyle. Profesjonalne podejście wymaga korzystania z debugowania rozsądnie – nie na co dzień, lecz wtedy, gdy naprawdę potrzebujesz pełnej kontroli nad technicznym działaniem sklepu.

W razie pytań skontaktuj się z nami mailowo lub telefonicznie. Pozostajemy do Twojej dyspozycji!