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":

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

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:

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

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") :

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):

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

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:

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):

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

• ~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.

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.