Activer la journalisation et l'affichage des erreurs PHP

Vérifié le 27 octobre 2026 4 min de lecture débogage PHP

Quand un site affiche une page blanche ou une erreur 500, le message PHP qui en explique la cause n'est pas visible par défaut. Vous pouvez le faire enregistrer dans un fichier journal (c'est le plus recommandé) ou, pendant quelques minutes, l'afficher à l'écran.

Option 1 : depuis le .htaccess

C'est la méthode la plus rapide et elle ne concerne que le site où vous la mettez.

Dans cPanel, ouvrez le Gestionnaire de fichiers et allez dans public_html (ou dans le dossier du domaine en erreur). Activez Afficher les fichiers cachés dans Paramètres si vous ne voyez pas le .htaccess ; s'il n'existe pas, créez-le.
Ajoutez au début du fichier :

php_value error_reporting -1
php_flag display_errors Off
php_flag log_errors On
php_value error_log /home/USUARIO_CPANEL/error_log

Remplacez USUARIO_CPANEL par votre nom d'utilisateur cPanel (il apparaît dans la colonne de droite de cPanel, dans Informations générales).
Rechargez la page en erreur.

Les erreurs seront enregistrées dans le fichier error_log du dossier principal du compte, en dehors de public_html : personne ne pourra donc le télécharger depuis le site. Ouvrez-le avec le gestionnaire de fichiers : les dernières lignes sont les plus récentes.

Option 2 : depuis le sélecteur PHP de cPanel

Dans cPanel, allez dans Select PHP Version et ouvrez l'onglet Options.
Passez log_errors sur On. L'enregistrement est automatique.

Cette modification concerne tous les sites du compte qui utilisent cette version de PHP. Les erreurs sont enregistrées dans un fichier error_log dans le même dossier que le script en erreur (normalement public_html).

Afficher les erreurs à l'écran

Si vous devez voir l'erreur directement dans le navigateur, passez display_errors sur On : dans le .htaccess, avec php_flag display_errors On, ou dans l'onglet Options du sélecteur PHP.

Ne le faites que le temps nécessaire pour voir l'erreur et remettez-le sur Off : le message peut montrer à n'importe quel visiteur des chemins internes ou des informations de connexion à la base de données.

WordPress dispose en plus de son propre mode de débogage, expliqué dans déboguer les erreurs dans WordPress.

Comment lire l'erreur

Chaque ligne du journal indique la date, le type d'erreur, le message ainsi que le fichier et la ligne où elle s'est produite, par exemple :

[27-Oct-2026 10:15:02 Europe/Madrid] PHP Fatal error:  Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes) in /home/usuario/public_html/wp-content/plugins/ejemplo/ejemplo.php on line 42

Fatal error est ce qui casse la page ; les Warning, Notice et Deprecated normalement non.
Le chemin vous indique le coupable : s'il se trouve dans wp-content/plugins/ejemplo, le problème vient de ce plugin.

Si le error_log n'apparaît pas

Vérifiez que le nom d'utilisateur cPanel du chemin est correct.
Si l'ajout des lignes au .htaccess provoque une erreur 500, retirez-les et utilisez l'option 2.
Si la page est en erreur mais que rien n'est enregistré, l'erreur ne vient peut-être pas de PHP : consultez Métriques > Erreurs dans cPanel.

Quand vous avez terminé, retirez les lignes du .htaccess ou remettez log_errors comme avant, et supprimez le error_log pour qu'il ne continue pas de grossir.