Jak włączyć tryb dewelopera w PrestaShop?

Do czego służy tryb dewelopera?

Tryb dewelopera (debug mode) w PrestaShop sprawia, że zamiast generycznych komunikatów o błędach widzisz:

• Pełne komunikaty błędów PHP z numerami linii
• Stack trace (stos wywołań) przy wyjątkach
• Szczegółowe informacje o zapytaniach SQL (opcjonalnie)
• Wyłączone cachowanie szablonów Smarty

Bez trybu dewelopera: strona pokazuje “Wystąpił błąd” — z nim: dokładnie która linia kodu i dlaczego.

Metoda 1: Przez panel admina (PrestaShop 1.7+)

1. Zaloguj się do panelu administracyjnego
2. Przejdź do Konfiguracja Zaawansowana → Wydajność
3. Znajdź sekcję Tryb debugowania
4. Ustaw Włącz tryb debugowania na TAK
5. Kliknij Zapisz

To najprostsza metoda — nie wymaga dostępu przez FTP.

Metoda 2: Przez plik konfiguracyjny

Edytuj plik config/defines.inc.php na serwerze:

// Znajdź i zmień:
define('_PS_MODE_DEV_', false);

// Na:
define('_PS_MODE_DEV_', true);

Ta metoda działa nawet gdy panel admina jest niedostępny (np. po błędnym kodzie).

Metoda 3: Plik .env / defines_custom.inc.php (PS 8.x)

W PrestaShop 8.x możesz też użyć pliku app/config/parameters.php lub zmiennej środowiskowej:

// config/defines_custom.inc.php (utwórz jeśli nie istnieje)
<?php
define('_PS_MODE_DEV_', true);

Co włącza tryb dewelopera?

• Błędy PHP wyświetlane na stronie (zamiast pustej strony lub “Oops”)
• Wyłączony cache Smarty — zmiany w szablonach widoczne od razu
• Toolbar deweloperski (PrestaShop DevBar) — statystyki zapytań SQL i czas generowania strony
• Szczegółowe wyjątki z pełnym stack trace

Uwaga: tryb dewelopera na produkcji

Nigdy nie zostawiaj trybu dewelopera włączonego na działającym sklepie. Powody:

• Błędy PHP pokazują strukturę plików serwera — informacja dla potencjalnych atakujących
• Wyłączone cache znacznie spowalnia sklep
• Klienci widzą techniczne komunikaty zamiast przyjaznych stron błędów

Zasada: włącz → zdebuguj → wyłącz.

Dodatkowe narzędzia do debugowania

• Xdebug — rozszerzenie PHP do krokowego debugowania (wymaga IDE: PhpStorm, VS Code)
• PrestaShop DevBar — pasek narzędzi widoczny na dole strony w trybie dev
• Logi PHP — zazwyczaj w /var/log/apache2/error.log lub w panelu hostingu
• PrestaShopException — PrestaShop loguje błędy też do var/logs/

Masz błąd w sklepie PrestaShop, który trudno zdiagnozować? Napisz do mnie — diagnozuję i naprawiam błędy PrestaShop sprawnie.