
# Zaznamenávání chyb

Pro požadavek vybraného sandboxu bootstrap nastaví `WP_DEBUG` na `true`, `WP_DEBUG_LOG` na sandbox `debug.log` a `WP_DEBUG_DISPLAY` na `false`, takže se chyby zapisují do souboru pro daný sandbox místo do prohlížeče.

Každá z těchto hodnot se nastaví pouze tehdy, pokud ji již nenastavil `wp-config.php`, a řádek bootstrapu se nachází přímo nad řádkem `wp-settings.php`, za zbytkem `wp-config.php`. Standardní `wp-config.php` nastavuje `WP_DEBUG` na `false`, takže při takové instalaci se požadavky sandboxu nezapisují do `debug.log` ([issue #4](https://github.com/inline0/rudel/issues/4)). Chcete-li tam protokoly pro jednotlivé sandboxy, odeberte definice `WP_DEBUG`, `WP_DEBUG_LOG` a `WP_DEBUG_DISPLAY` z `wp-config.php`. WordPress pak ponechá ladění pro požadavky hostitele vypnuté a bootstrap zapne zaznamenávání pro požadavky sandboxu.

## Zobrazení protokolů

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

Výchozí nastavení zobrazuje posledních 50 řádků. `--follow` nad souborem spustí `tail -f`.

## Mazání protokolů

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

## Umístění protokolu

Soubor protokolu se nachází v adresáři sandboxu:

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

Tento adresář je uvnitř `wp-content` a webové servery z něj poskytují soubory jako z kteréhokoli jiného umístění. Na každém hostiteli dostupném ostatním zablokujte webový přístup k souborům `*.log` a adresářům `snapshots` pod `rudel-environments` ([issue #9](https://github.com/inline0/rudel/issues/9)).

## Blokování e-mailů

Požadavky sandboxu blokují odchozí e-maily. Pokud je definováno `WP_DEBUG_LOG`, každá zablokovaná zpráva se zaznamená spolu s příjemcem a předmětem prostřednictvím `error_log()`. Do sandboxu `debug.log` se dostane pouze tehdy, když je aktivní ladicí protokolování popsané výše; jinak se zapíše do výchozího protokolu chyb PHP.
