Notez cet article :
5/5 | 1 avis
Cet article vous a été utile ?
Oui
Non
Vous avez noté 0 étoile(s)
Sommaire
Définition
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
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 :
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.
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 :
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 :
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).
Pour consulter le journal des erreur PHP, depuis l'outil Gestionnaire de fichier de votre 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
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 ?
Oui
Non
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 ?