### [Como ativar a depuração no WordPress](https://wpforms.com/developers/how-to-enable-debugging-in-wordpress/)

**Publicado:** 8 de janeiro de 2021
**Autor:** Umair Majeed

**Resumo:** Este tutorial irá guiá-lo sobre como habilitar a depuração no WordPress enquanto realiza alguns testes de possíveis conflitos de plugins ou temas, bem como verifica se há erros de PHP. 

**Conteúdo:**

Ao solucionar problemas com plugins, temas ou código personalizado do WordPress, pode ser necessário habilitar a depuração do WordPress. Esse recurso registra todos os erros detectados em seu site, ajudando a identificar a origem dos problemas ou a reunir mais detalhes sobre possíveis falhas.

Este guia mostrará como habilitar a depuração com segurança no seu site WordPress.

## Habilitando a depuração no WordPress

Para habilitar a depuração no seu site, siga as etapas abaixo.

#### 1) Localizando o arquivo `wp-config.php`

Por padrão, a depuração do WordPress estará desativada. Para ativá-la, você precisará acessar os arquivos do seu site por meio de um FTP (Protocolo de Transferência de Arquivos) ou do cPanel do seu servidor.

Para saber mais sobre FTP, [confira este artigo do WPBeginner](http://www.wpbeginner.com/glossary/ftp/). Como alternativa, nossos amigos do WPBeginner também têm um artigo com informações sobre o cPanel, [que você pode ver aqui](http://www.wpbeginner.com/glossary/cpanel).

Como alternativa, você também pode simplesmente instalar um plugin como o WP File Manager para acessar facilmente os arquivos do seu servidor através da área de administração do WordPress. Para saber mais sobre esse plugin, [confira-o no WordPress.org](https://www.wpbeginner.com/plugins/how-to-add-a-ftp-like-file-manager-in-wordpress-with-wp-file-manager/).

#### 2) Editando o arquivo `wp-config.php`

Depois que os arquivos do seu site estiverem abertos, você precisará abrir o `wp-config.php` para edição.

Esse arquivo estará localizado na pasta raiz do seu servidor. Para saber mais sobre a localização e as instruções de diretório, [consulte este artigo](http://www.wpbeginner.com/beginners-guide/beginners-guide-to-wordpress-file-and-directory-structure/).

![Abra o arquivo wp-config para habilitar a depuração no WordPress](https://wpforms.com/wp-content/uploads/2019/08/ftp-edit-wp-config-file.jpg)Para mais exemplos sobre como editar o arquivo **wp-config.php**, confira este [artigo do WPBeginner sobre como editar o arquivo wp-config no WordPress](https://www.wpbeginner.com/beginners-guide/how-to-edit-wp-config-php-file-in-wordpress/).

Localize o arquivo wp-config.php no diretório raiz do seu site. Esse arquivo contém as configurações principais do seu site.

Encontre esta linha na parte inferior do arquivo:

```

('WP_DEBUG', false);
```

#### 3) Ativando a depuração

Substitua-a por este trecho de código com a configuração de depuração:

```

// Ativar o modo WP_DEBUG
define( 'WP_DEBUG', true );

// Ativar o registro de depuração no arquivo /wp-content/debug.log
define( 'WP_DEBUG_LOG', true );

// Desativar a exibição de erros e avisos
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

// Usar versões de desenvolvimento dos arquivos JS e CSS do núcleo (necessário apenas se você estiver modificando esses arquivos do núcleo)
define( 'SCRIPT_DEBUG', true );
```

Observação: Adicione este código antes da linha que diz “/\* Isso é tudo, pare de editar! Boas postagens. \*/”

![Habilite a depuração dentro do arquivo wp-config.php](https://wpforms.com/wp-content/uploads/2021/01/wpforms-debug-code.jpg)Isso habilitará a depuração e, mais importante, impedirá que quaisquer dados registrados sejam exibidos no seu site. Em vez disso, um log de depuração será salvo nos arquivos do seu site.

#### 4) Reproduzindo o problema

Depois de salvar essas alterações no `wp-config.php`, você precisará retornar ao seu site e reproduzir o problema que observou anteriormente. Isso garantirá que ele seja registrado no novo log de erros.

#### 5) Visualizando o log de depuração

Em seguida, você pode retornar aos arquivos do seu site e abrir `https://yoursitename.com/wp-content/debug.log`

**Observação:** Saiba que a URL do debug.log dependerá exatamente de como seu site está configurado. Por exemplo, se seu site estiver instalado em um subdiretório, a URL principal pode ser algo como: `https://yoursitename.com/your-subdirectory-name/wp-content/debug.log`. Verifique com sua empresa de hospedagem se você não tiver certeza de como acessar esse arquivo.

O conteúdo de um log de erros pode variar bastante dependendo da causa e do número de problemas, mas agora você deve conseguir ver detalhes adicionais, como o caminho do arquivo para a origem de um erro de código, para ajudá-lo a identificar melhor o problema.

Para informações mais detalhadas sobre a depuração do WordPress, consulte a [Documentação Oficial de Depuração do WordPress](https://developer.wordpress.org/advanced-administration/debug/debug-wordpress/).

**Categorias:** Introdução

**Tags:** PHP

---