Desenvolvimento e bases de dados

Personalizar as páginas de erro 404 e outras respostas

Revisto a 4 min de leitura páginas de erro cPanel

Uma página de erro útil explica o que aconteceu e oferece uma saída, como voltar ao início ou procurar outro conteúdo. Pode personalizar as respostas do servidor a partir de cPanel > Error Pages. Se usar WordPress, Joomla, PrestaShop, Magento ou semelhantes, esta opção não tem efeito: a aplicação gere as suas próprias páginas de erro a partir do tema ou do modelo.

Criar a página no cPanel

  1. Abra Error Pages e selecione o domínio correto, se aparecer um seletor.

  2. Escolha o código que vai personalizar, por exemplo 404, para um endereço que não existe.

    Escolher o código de erro em Error Pages do cPanel

  3. Escreva o conteúdo no editor. Admite HTML, por isso pode colocar o seu logótipo, uma mensagem e ligações para a página inicial ou para o motor de pesquisa. Com os botões da parte superior insere etiquetas que mostram dados do pedido: o URL pedido, a página de origem (referring URL), o IP ou o navegador do visitante e o nome do servidor.

    Editor da página de erro com as etiquetas disponíveis

  4. Guarde e visite um URL inexistente desse domínio.

O cPanel guarda a página como 404.shtml na pasta raiz do domínio; também pode carregar esse ficheiro diretamente por FTP. Se acrescentar imagens ou estilos, verifique os seus caminhos a partir de um endereço inexistente situado também numa subpasta. Os recursos da página de erro devem continuar disponíveis quando a falha ocorrer.

Manter o código HTTP correto

O aspeto da página e o seu código HTTP são coisas diferentes. Um 404 deve continuar a responder 404, mesmo que mostre um design completo. Devolver 200 com uma mensagem de «não encontrado» pode levar os motores de pesquisa a interpretá-lo como um soft 404.

Verifique o estado no separador Rede / Network das ferramentas do navegador, depois de recarregar um URL inexistente. Se utilizar uma ferramenta de terminal, consulte os cabeçalhos da resposta real e reveja possíveis redirecionamentos.

Para manutenção temporária, utilize uma resposta 503, com uma página leve e independente da aplicação que está em manutenção. Consulte o guia de manutenção com .htaccess.

Quando a alteração não aparece

Se a aplicação captar o pedido antes do servidor, personalize a página de erro dentro da aplicação ou do seu tema. Reveja também caches e proxies que possam estar a mostrar uma resposta própria.

Evite incluir caminhos internos, rastreios, credenciais ou detalhes do servidor na página pública. Se utilizar etiquetas que inserem dados do pedido, verifique o seu tratamento e não acrescente conteúdo recebido do visitante sem o escape adequado.

Uma página personalizada ajuda o visitante, mas não corrige a origem de um erro 500 nem recupera um URL que deveria existir. Nesses casos, reveja os registos ou restaure o caminho correspondente.

Também lhe pode ser útil

Algo não bate certo ou mudou? Diga-nos e revemos.