Os registos de erros guardam os problemas que ocorrem no seu website, incluindo erros de PHP, falhas de ligação à base de dados e problemas de plugins. Quando algo corre mal no seu site, o registo de erros é muitas vezes a forma mais rápida de identificar a causa.
Aceder aos registos através do Gestor de Ficheiros ou SFTP
O KPanel não tem um separador dedicado a registos. Os ficheiros de registo são guardados no servidor e podem ser acedidos através do Gestor de Ficheiros ou de SFTP.
Utilizando o Gestor de Ficheiros:
- Inicie sessão no KPanel em kpanel.kapsulehost.com
- Aceda a Websites e selecione o site afetado
- Clique em Definições → Gestor de Ficheiros
- Navegue até ao diretório
logs/na raiz do seu site
Utilizando SFTP:
- Aceda a Definições → SFTP no KPanel para obter os detalhes de ligação do seu site
- Ligue-se com o FileZilla ou com o seu cliente SFTP preferido
- Navegue até ao diretório
logs/na raiz do seu site
O diretório logs/ contém:
- Registo de erros do PHP, erros gerados pelo código PHP (o registo mais frequentemente necessário)
- Registo de acesso, um registo de todos os pedidos HTTP ao seu site
- Registo de erros, erros ao nível do servidor (500, 502, etc.)
Ler um registo de erros do PHP
Uma entrada típica de um registo de erros do PHP tem este aspeto:
[03-Jun-2026 14:32:11 UTC] PHP Fatal error: Call to undefined function get_header() in /var/www/sites/yourdomain/public_html/wp-content/themes/mytheme/page.php on line 8
Isto indica-lhe a data e hora, o tipo de erro, uma descrição do problema e o caminho do ficheiro e número da linha onde o erro ocorreu.
Tipos de erros comuns
| Tipo | Gravidade | O que significa |
|---|---|---|
| Erro fatal | Alta | A execução parou. A página não carrega. |
| Aviso | Média | Aconteceu algo inesperado, mas a execução continuou. |
| Nota | Baixa | Problema menor, normalmente uma violação de boas práticas de programação. |
| Obsoleto | Baixa | Uma função utilizada será removida numa versão futura do PHP. |
Ativar o modo de depuração do WordPress
Para sites WordPress, ativar o modo de depuração apresenta informação de erro mais detalhada:
- Ligue-se via SFTP ou utilize o Gestor de Ficheiros no KPanel
- Abra
wp-config.phpna raiz do WordPress - Adicione ou atualize estas linhas:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Os erros serão escritos em wp-content/debug.log em vez de serem apresentados no ecrã.
Não deixe WP_DEBUG_DISPLAY definido como true num site em produção, pois isto pode expor informação sensível aos visitantes.
Verifique os registos de erros imediatamente após atualizar o WordPress, plugins ou temas. Muitos problemas pós-atualização deixam vestígios claros no registo de erros do PHP.