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"

Comment consulter les fichiers logs Apache et PHP sur cPanel

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

Comment consulter les fichiers logs Apache et PHP sur cPanel

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

Comment consulter les fichiers logs Apache et PHP sur cPanel

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

Comment consulter les fichiers logs Apache et PHP sur cPanel

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

Comment consulter les fichiers logs Apache et PHP sur cPanel

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

Comment consulter les fichiers logs Apache et PHP sur cPanel

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

Comment consulter les fichiers logs Apache et PHP sur cPanel

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

Comment consulter les fichiers logs Apache et PHP sur cPanel

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

Comment consulter les fichiers logs Apache et PHP sur cPanel

Comment consulter les fichiers logs Apache et PHP sur cPanel

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.

Notez cet article :

5/5 | 1 avis

Cet article vous a été utile ?

Article utileOui

Article non utileNon

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

Merci ! 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)

Articles similaires

0mn de lecture

Comment créer et gérer une liste de diffusion sur CPANEL

0mn de lecture

Comment maintenir à jour les coordonnées de vos contacts dans cPanel ?

0mn de lecture

Comment utiliser le courriel Web dans cPanel ?

0mn de lecture

Comment créer une redirection web dans cPanel ?


Poser une question à l'équipe LWS et à sa communauté