# Rejestrowanie błędów

W przypadku żądania w wybranej piaskownicy bootstrap ustawia `WP_DEBUG` jako `true`, `WP_DEBUG_LOG` jako piaskownicę `debug.log`, a `WP_DEBUG_DISPLAY` jako `false`, dzięki czemu błędy trafiają do osobnego pliku piaskownicy zamiast do przeglądarki.

Każda z tych stałych jest definiowana tylko wtedy, gdy `wp-config.php` nie ustawiło jej wcześniej, a wiersz bootstrapu znajduje się bezpośrednio nad wierszem `wp-settings.php`, za pozostałą częścią `wp-config.php`. Standardowa instalacja `wp-config.php` ustawia `WP_DEBUG` jako `false`, więc na takiej instalacji żądania piaskownicy nie zapisują logów w `debug.log` ([zgłoszenie nr 4](https://github.com/inline0/rudel/issues/4)). Aby włączyć tam osobne dzienniki, usuń definicje `WP_DEBUG`, `WP_DEBUG_LOG` i `WP_DEBUG_DISPLAY` z `wp-config.php`. WordPress nadal wyłącza debugowanie dla żądań hosta, a bootstrap włącza rejestrowanie dla żądań piaskownicy.

## Wyświetlanie dzienników

```bash
wp rudel logs alpha-3be7
wp rudel logs alpha-3be7 --lines=200
wp rudel logs alpha-3be7 --follow
```

Domyślnie wyświetlanych jest 50 ostatnich wierszy. `--follow` uruchamia `tail -f` na pliku.

## Czyszczenie dzienników

```bash
wp rudel logs alpha-3be7 --clear
```

## Lokalizacja dziennika

Plik dziennika znajduje się w katalogu piaskownicy:

```text
wp-content/rudel-environments/{id}/debug.log
```

Ten katalog znajduje się wewnątrz `wp-content`, a serwery WWW udostępniają go jak każdy inny znajdujący się tam plik. Zablokuj dostęp przez WWW do plików `*.log` oraz katalogów `snapshots` w obrębie `rudel-environments` na każdym hoście dostępnym dla innych osób ([zgłoszenie nr 9](https://github.com/inline0/rudel/issues/9)).

## Zablokowana poczta e-mail

Żądania piaskownicy blokują wychodzącą pocztę e-mail. Gdy zdefiniowano `WP_DEBUG_LOG`, każda zablokowana wiadomość jest rejestrowana wraz z odbiorcą i tematem za pomocą `error_log()`. Trafia do piaskownicy `debug.log` tylko wtedy, gdy aktywne jest rejestrowanie debugowania opisane powyżej; w przeciwnym razie trafia do domyślnego dziennika błędów PHP.