Introdução

De tempos em tempos, o Joomla pode exibir uma página de erro em vez da página que você esperava. Existem dois tipos de páginas de erro:

  • A página de erro do sistema tem um fundo vermelho. Ela é invocada se houver um erro grave antes que o tema do site ou da administração seja renderizado.
  • A página de erro do tema se parece com o tema normal do site ou da administração, mas a área de conteúdo é substituída por uma mensagem de erro. Isso é invocado quando o erro ocorre no código de conteúdo.

Página de Erro do Sistema

System fatal error page

Página de Erro do Tema

Template error page

Como resolver

Existem várias razões possíveis para a ocorrência de erros fatais. Aqui estão apenas algumas:

  • Uma mudança em sua hospedagem, por exemplo, uma versão atualizada do PHP que não é compatível com o Joomla ou com uma de suas Extensões.
  • Um problema com espaço em disco, uso de memória ou tempo limite de script.
  • Uma Extensão recém-instalada ou ativada que não é compatível com o Joomla. Um plugin com defeito pode desativar o acesso do Administrador!

Habilitar depuração

Se sua interface de Administrador ainda estiver funcionando:

  • Vá até Painel inicial → painel Sistema → Configuração Global.
  • Na aba Sistema, defina Depuração do Sistema como Sim
  • Na aba Servidor, defina Relatório de Erros como Máximo.
  • Depois Salvar e fechar.

Se sua interface de Administrador não estiver funcionando, edite o arquivo configuration.php na pasta raiz do seu site Joomla.

  1. Altere as permissões de 444 ou -r--r--r-- (ninguém tem permissão para gravar no arquivo) para 644 ou -rw-r--r-- (somente o Proprietário tem permissão para gravar).
  2. Edite o arquivo com um editor de texto e defina $debug como true e $error_reporting como 'maximum'.
  3. Salve o arquivo.

Com as alterações feitas, recarregue a página que estava causando o erro. Agora você deve ver um stack trace. Exemplo:

Template error page

O primeiro item no rastreamento de pilha indica onde o erro foi acionado. Às vezes isso é suficiente para identificar a extensão com defeito. Às vezes a extensão com defeito está mais abaixo no rastreamento de pilha. Pode não significar muito para você, mas o rastreamento de pilha é inestimável para os especialistas que respondem perguntas nos Fóruns Joomla.

Se você conseguir identificar a extensão com defeito, desative-a. Você pode fazer isso usando a interface do Administrador, se ela estiver funcionando. Caso contrário, use o phpMyAdmin para encontrar a extensão na tabela do banco de dados #__extensions e definir seu valor enabled como 0. Você não deveria precisar desativar nenhuma extensão principal do Joomla.

Forum Post Assistant

Para ajudar a resolver problemas, você deve baixar o Forum Post Assistant (FPA) e carregá-lo na raiz do seu site Joomla. O link para encontrá-lo também fica próximo ao topo de cada página do Fórum Joomla. O FPA é um script PHP independente que analisa sua instalação do Joomla e informa o que pode estar errado. Novamente, pode não significar muito para você, mas os especialistas que respondem perguntas nos Fóruns podem pedir para vê-lo.

Limpeza

Quando seu problema for resolvido:

  1. Vá até Painel inicial → painel Sistema → Configuração Global
  2. Selecionar a aba Sistema e definir Depurar sistema como Não.
  3. Selecionar a aba Servidor e definir Relatório de erros como Padrão do sistema.
  4. Salvar e fechar.
  5. Remover o Forum Post Assistant.

As permissões do configuration.php são definidas como somente leitura (444 ou r--r--r--) quando o formulário de Configuração Global é salvo. Não há necessidade de fazer isso manualmente.