# Registro de erros

Para uma solicitação de sandbox selecionado, o bootstrap define `WP_DEBUG` como `true`, `WP_DEBUG_LOG` como o `debug.log` do sandbox e `WP_DEBUG_DISPLAY` como `false`, para que os erros sejam enviados a um arquivo por sandbox em vez de ao navegador.

Cada uma dessas definições só é feita se `wp-config.php` ainda não a tiver definido, e a linha de bootstrap fica logo acima da linha `wp-settings.php`, depois do restante de `wp-config.php`. Uma instalação padrão de `wp-config.php` define `WP_DEBUG` como `false`, portanto, nessa instalação, as solicitações do sandbox não são registradas em `debug.log` ([issue #4](https://github.com/inline0/rudel/issues/4)). Para obter logs por sandbox nesse caso, remova as definições de `WP_DEBUG`, `WP_DEBUG_LOG` e `WP_DEBUG_DISPLAY` de `wp-config.php`. WordPress então mantém a depuração desativada para solicitações do host, e o bootstrap ativa o registro para solicitações do sandbox.

## Visualizar logs

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

O padrão são as últimas 50 linhas. `--follow` executa `tail -f` no arquivo.

## Limpar logs

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

## Local dos logs

O arquivo de log fica no diretório do sandbox:

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

Esse diretório fica dentro de `wp-content`, e os servidores Web o disponibilizam como qualquer outro arquivo ali. Bloqueie o acesso pela Web aos arquivos `*.log` e aos diretórios `snapshots` sob `rudel-environments` em qualquer host acessível por outras pessoas ([issue #9](https://github.com/inline0/rudel/issues/9)).

## E-mail bloqueado

As solicitações de sandbox bloqueiam o envio de e-mails. Quando `WP_DEBUG_LOG` está definido, cada mensagem bloqueada é registrada com o destinatário e o assunto por meio de `error_log()`. Ela só chega ao `debug.log` do sandbox quando o registro de depuração está ativo, conforme descrito acima; caso contrário, vai para o log de erros padrão de PHP.