Przejdź do głównej treści

Logowanie błędów PHP

Słownik kwalifikacji INF.03 - Tworzenie i administrowanie stronami i aplikacjami internetowymi oraz bazami danych

Logowanie błędów PHP polega na zapisywaniu informacji o błędach działania skryptów PHP do pliku logu lub logu serwera. Dzięki temu administrator lub programista może sprawdzić, co poszło nie tak, nawet jeśli użytkownik strony nie widzi komunikatu błędu.

Kiedy błędy są zapisywane?

Błędy PHP są zapisywane w logu wtedy, gdy w konfiguracji PHP włączono odpowiednie ustawienie:

log_errors = On

Dodatkowo można wskazać konkretny plik logu:

error_log = /var/log/php_errors.log

Jeśli plik nie zostanie wskazany, błędy mogą trafiać do domyślnego logu serwera WWW, np. Apache lub Nginx, zależnie od konfiguracji środowiska.

Wyświetlanie a logowanie błędów

Nie należy mylić dwóch ustawień:

  • display_errors - pokazuje błędy w przeglądarce,
  • log_errors - zapisuje błędy w logu.

Na serwerze produkcyjnym zwykle stosuje się:

display_errors = Off
log_errors = On

Dzięki temu użytkownik nie widzi szczegółów błędu, ale programista może je odczytać z logu.

Najważniejsza zasada

Błędy interpretacji kodu PHP nie są zapisywane „same z siebie” w edytorze ani ignorowane przez interpreter. Mogą trafić do logu, jeśli odpowiednio skonfigurowano PHP, najczęściej w pliku php.ini.