Como ver os ficheiros de registo do Apache e do PHP no cPanel

Procédure

O que são ficheiros de registo?

Os ficheiros de registo (também conhecidos como ficheiros de cookies ou registos de erros) são ficheiros que registam determinados tipos de eventos com um certo nível de detalhe. Os ficheiros de registo de erros do Apache registam todos os eventos de erro encontrados pelo Apache (e, por conseguinte, pelo PHP) durante uma visita ao seu sítio Web, juntamente com os detalhes do erro encontrado.

Os ficheiros de registo são, portanto, uma ferramenta crucial para compreender melhor uma situação de erro, disponibilizando mais detalhes. Neste artigo, veremos como apresentar os registos de erros do Apache e do PHP no seu alojamento cPanel.

Consultar o ficheiro de registo do Apache

Pode visualizar o registo de erros do Apache seguindo os passos abaixo:

  1. Inicie sessão no seu cPanel
  2. Clique no ícone Logs localizado na secção "Medidas":

Como ver os ficheiros de registo do Apache e do PHP no cPanel

3. Na secção"Ficheiros de registo do site" (1), seleccione o botão"Registo de erros" (2) :

Como ver os ficheiros de registo do Apache e do PHP no cPanel

4. É apresentada uma lista dos ficheiros de registo disponíveis com as respectivas datas de arquivamento, se aplicável. Clique no botão"Ver" correspondente ao ficheiro de registo que pretende visualizar:

Como ver os ficheiros de registo do Apache e do PHP no cPanel

5. São então apresentadas as últimas 300 linhas do ficheiro de registo:

Como ver os ficheiros de registo do Apache e do PHP no cPanel

Pode utilizar o campo " Filter" (Filtro ) para filtrar a lista ou utilizar o botão " Download " (Descarregar) para descarregar o ficheiro de registo completo.

Ver o registo de erros do PHP

Por defeito, os erros do PHP são enviados e registados no ficheiro de registo de erros do Apache. Este comportamento é reproduzido graças à ausência de conteúdo no parâmetro error_log da sua configuração php.ini.

No entanto, se desejar registar os seus erros PHP noutro local, pode personalizar este parâmetro php.ini. Para tal, clique no ícone"Selecionar uma versão PHP" na sua interface cPanel (secção"Software") :

Como ver os ficheiros de registo do Apache e do PHP no cPanel

Clique no separador"Opções" para aceder aos parâmetros php.ini e selecionar a versão PHP em questão (se o sítio Web a depurar utilizar uma versão PHP diferente, modificando o ficheiro .htaccess):

Como ver os ficheiros de registo do Apache e do PHP no cPanel

Procure a opção error_log e especifique um caminho de ficheiro para armazenar os seus erros:

Como ver os ficheiros de registo do Apache e do PHP no cPanel

Certifique-se de que a caixa de verificação log_errors está activada para que o PHP utilize o ficheiro especificado para escrever os registos:

Como ver os ficheiros de registo do Apache e do PHP no cPanel

Também pode marcar a caixa"display_errors" para apresentar os erros diretamente no seu navegador Web (tenha cuidado, as mensagens de erro podem conter informações sensíveis, como palavras-passe ou os nomes das suas bases de dados MySQL):

Como ver os ficheiros de registo do Apache e do PHP no cPanel

É possível reajustar o parâmetro error_reporting para filtrar os níveis de erro a serem exibidos:

Como ver os ficheiros de registo do Apache e do PHP no cPanel

  • ~E_ALL: não serão exibidas mensagens de erro
  • E_ALL: todas as mensagens de erro serão exibidas
  • E_ALL & ~E_NOTICE: são apresentados todos os erros, exceto os avisos
  • E_ALL & ~E_DEPRECATED & ~E_STRICT: todos os erros, exceto deprecações e avisos de compatibilidade/interoperabilidade, serão exibidos.

Veja detalhes sobre os níveis de erro do PHP.

Se o caminho do seu arquivo error_log não começa com um "/", então o caminho é relativo ao CWD (Current Working Directory) do processo PHP que o está executando. Com o ambiente HTTP do cPanel, isto refere-se ao diretório que contém o ficheiro PHP que está a ser executado pela LSAPI.

Por exemplo

  • O seu URL: https://monsite.com/dossier/lapage
  • O ficheiro PHP associado indicado pelo .htaccess: /home/c1234567c/public_html/dossier/index.php
  • No ficheiro index.php, existe um include que aponta para /home/c1234567c/public_html/dossier/common/header.php
  • É o ficheiro header.php que encontrou um erro
  • A sua configuração do error_log: logs/error.log
  • O seu ficheiro de erro será, portanto, /home/c1234567c/public_html/dossier/logs/error.log

Para facilitar a utilização, utilize sempre um caminho absoluto.

Se o caminho do seu ficheiro error_log apontar para /dev/null, então o ficheiro de registo não será criado. /dev/null é um ficheiro "mágico" no Linux que lhe permite esquecer qualquer entrada que lhe seja dada.

Por razões de segurança, é preferível colocar o ficheiro de registo de erros numa pasta inacessível aos visitantes (para além de public_html) para evitar que informações privadas, como o nome da sua base de dados, que possam aparecer nos registos, sejam reveladas. Da mesma forma, aconselhamos vivamente a não permitir que os erros de PHP sejam apresentados aos seus visitantes.

Ver o seu ficheiro de registo PHP personalizado no gestor de ficheiros

Para ver o registo de erros de PHP que acabou de configurar, a partir da ferramenta Gestor de ficheiros no seu cPanel :

  1. Localize o ficheiro de registo tal como o definiu na secção anterior e clique com o botão direito do rato e, em seguida, escolha a opção Ver para visualizar o ficheiro.

Como ver os ficheiros de registo do Apache e do PHP no cPanel

Como ver os ficheiros de registo do Apache e do PHP no cPanel

No ficheiro, verá cada erro que foi registado numa linha separada. Primeiro, lista a data e a hora em que o erro foi produzido e, em seguida, o erro real. A revisão periódica destas informações ajudá-lo-á a proporcionar a melhor experiência possível aos seus visitantes, para garantir que não vêem erros repetidos no seu sítio Web.

Conclusão

Neste artigo, aprendeu a visualizar os registos do Apache/PHP do seu alojamento. Pode utilizar esta ferramenta para detetar actividades suspeitas através do registo do Apache ou reparar erros de PHP relacionados com o seu sítio Web, visualizando o ficheiro de erros do PHP.

Avaliar este artigo :

5/5 | 1 opinião

Este artigo foi útil para si ?

Article utileSim

Article non utileNão

Vous souhaitez nous laisser un commentaire concernant cet article ?

Si cela concerne une erreur dans la documentation ou un manque d'informations, n'hésitez pas à nous en faire part depuis le formulaire.

Pour toute question non liée à cette documentation ou problème technique sur l'un de vos services, contactez le support commercial ou le support technique

MerciMerci ! N'hésitez pas à poser des questions sur nos documentations si vous souhaitez plus d'informations et nous aider à les améliorer.


Vous avez noté 0 étoile(s)

Artigos semelhantes

3mn leitura

Wordpress no cPanel: Como resolver o problema da página branca ou do erro 500

1mn leitura

Diagnosticar e corrigir um erro 500 num site alojado no cPanel

0mn leitura

Como é que corrijo um erro 403 Forbidden no cPanel?

0mn leitura

Como é que corrijo um erro 404 no cPanel?


Fazer uma pergunta à equipa do LWS e à sua comunidade