Comment consulter les fichiers logs Apache et PHP sur cPanel

Définition

Qu'est-ce qu'un fichier log ?

Les fichiers logs (aussi appelé fichiers témoins ou journaux d'erreurs) sont des fichiers qui enregistrent certaines types d'événements avec un certain niveau de détails. Les fichiers logs d'erreurs Apache enregistrent les éventuelles événements d'erreurs rencontrés par Apache (et par conséquent, PHP) lors d'un visite sur votre site web avec les détails sur l'erreur rencontré.

Les fichiers logs sont par conséquent un outil crucial pour mieux comprendre une situation d'erreur en mettant à disposition plus de détails. Dans cet article, nous allons voir comment afficher les journaux d'erreurs Apache et PHP dans votre hébergement cPanel.

Procédure

Consultation du fichier log Apache

cPanel est livré avec une section de journal des erreurs qui vous permet de visualiser les erreurs générées par votre site web. Vous pouvez consulter le journal des erreurs Apache en suivant les étapes ci-dessous :

1. Connectez-vous à votre cPanel
2. Depuis la barre de recherche situé en haut de la page indiquez : Erreurs
3. Cliquez sur l'icone Erreurs situé dans la rubrique "Mesures"

Le  journal des erreurs Apache s'affichera dans la page qui va s'ouvrir.

cPanel affichera les 300 dernières erreurs vous concernant via cette page.

Visualiser le journal d'erreurs PHP

Bien que le journal d'erreurs Apache affiche certains erreurs liés à PHP, il vous est peut-être utile de dédié un journal d'erreur PHP.

Il existe deux méthodes pour afficher les erreurs PHP qui se produisent lors de l'exécution de votre site Web. Vous pouvez soit afficher les erreurs directement sur votre site web (visualisables à partir de n'importe quel navigateur web), soit activer la journalisation des erreurs pour écrire les erreurs dans un fichier spécifié (visualisables dans un fichier texte). Cet article couvrira les deux méthodes.

Pour activer l'affichage des erreurs PHP, il vous sera nécessaire d'éditer les configurations php.ini de la version PHP de votre site. Pour cela, cliquez sur l'icône "Sélectionner une version de PHP" sur votre interface cPanel (rubrique "Logiciel").

Cliquez sur l'onglet "Options" pour accéder aux paramètres php.ini et sélectionnez la version PHP concerné (si le site web à déboguer utilise une version PHP différente via la modification du fichier .htaccess) :

Recherchez l'option "display_errors" et cochez-le pour que PHP affiche directement tout erreur rencontré sur le navigateur web.

Le paramètre error_reporting permet de filtrer les niveaux d'erreurs à afficher :

• ~E_ALL : aucun message d'erreur ne sera affiché
• E_ALL : tous les messages d'erreurs seront affichés
• E_ALL & ~E_NOTICE : tous les erreurs, sauf les notices, seront affichés
• E_ALL & ~E_DEPRECATED & ~E_STRICT : tous les erreurs, sauf les dépréciations et les notices de compatibilité/interropérabilités seront affichés

Voir les détails sur les niveaux d'erreurs PHP.

L'option "log_errors" permet d'activer ou désactiver l'écriture du fichier log d'erreurs PHP :

Le chemin du fichier log d'erreurs PHP est défini par l'option error_log :

Si le chemin de votre fichier error_log ne commence pas par un "/", alors le chemin est relatif par rapport au CWD (Current Working Directory) du processus PHP qui l'exécute. Avec l'environnement HTTP de cPanel, celui-ci se rapporte au répertoire qui contient le fichier PHP exécuté par LSAPI.

Exemple :

• Votre URL : https://monsite.com/dossier/lapage
• Le fichier PHP associé qui est indiqué par le .htaccess : /home/c1234567c/public_html/dossier/index.php
• Dans le fichier index.php, il y a une include qui pointe sur /home/c1234567c/public_html/dossier/common/header.php
• C'est le fichier header.php qui rencontre une erreur
• Votre configuration error_log : logs/error.log
• Alors, votre fichier d'erreur sera /home/c1234567c/public_html/dossier/logs/error.log

Dans un souci de facilité, privilégiez toujours un chemin absolu.

Si le chemin de votre fichier error_log pointe sur /dev/null, alors le fichier log ne sera pas créé. /dev/null est un fichier "magique" sur Linux permettant d'oublier directement tout entrée qui lui est donné.

Dans un souci de sécurité, il est préférable de placer le fichier log d'erreurs dans un dossier innaccessible aux visiteurs (en dehors de public_html) afin d'éviter que des informations privées tel que le nom de votre base de données qui pourraient apparaître sur les logs ne soient dévoilés. De même, il est fortement conseillé de ne pas laisser les erreurs PHP affichés à vos visiteurs.

Dans un souci de performance, les fichiers logs d'erreurs PHP sont par défaut désactivés et/ou configurés sur /dev/null. En effet, si votre site web génère beaucoup d'erreurs peu pertinentes (notices, deprecated, ... par exemple), votre fichier log pourra rapidement gonfler en volume. En outre, chaque nouvelle visite enclenchera une écriture sur celui-ci, ce qui pourrait augmenter le temps de chargement de votre site (notamment si le fichier log est déjà suffisamment gros).

Par conséquent, nous recommandons de désactiver l'affichage des erreurs et de désactiver ou limiter les écritures de fichier de log (avec error_reporting ou tout simplement en résolvant les éventuelles problèmes logués).

Consulter votre fichier log sur le gestionnaire de fichiers

Pour consulter le journal des erreur PHP, depuis l'outil Gestionnaire de fichier de votre cPanel :

1. Accedez au dossier public_html
2. localisez le fichier log tel que vous l'avez défini sur la précédente section et faites un clic droit à l'aide de votre souris, puis choisissez l'option View afin de visualiser le fichier

Dans le fichier, vous verrez chaque erreur qui a été enregistrée sur une ligne distincte. Tout d'abord, il répertorie la date et l'heure auxquelles l'erreur a été produite, puis l'erreur réelle. Un examen périodique de ces informations vous aidera à offrir la meilleure expérience possible à vos visiteurs pour vous assurer qu'ils ne voient pas d'erreurs répétées sur votre site web.

Pour aller plus loin

Conclusion

Dans cet article vous avez appris comment consulter les logs Apache/PHP de votre hébergement, vous pouvez utiliser cet outil pour détecter une activité suspecte via le log Apache ou reparer les erreur PHP lié à votre site web en visualisant le fichier d'erreur PHP.