Les journaux d'erreurs enregistrent les problèmes qui surviennent sur votre site web, y compris les erreurs PHP, les échecs de connexion à la base de données et les problèmes liés aux extensions. Lorsqu'un problème survient sur votre site, le journal d'erreurs est souvent le moyen le plus rapide d'en identifier la cause.
Accéder aux journaux via le Gestionnaire de fichiers ou SFTP
KPanel ne dispose pas d'un onglet Journaux dédié. Les fichiers journaux sont stockés sur le serveur et peuvent être consultés via le Gestionnaire de fichiers ou en SFTP.
Avec le Gestionnaire de fichiers :
- Connectez-vous à KPanel sur kpanel.kapsulehost.com
- Allez dans Sites web et sélectionnez le site concerné
- Cliquez sur Settings → File Manager
- Accédez au répertoire
logs/à la racine de votre site
Avec SFTP :
- Allez dans Settings → SFTP dans KPanel pour obtenir les informations de connexion de votre site
- Connectez-vous avec FileZilla ou le client SFTP de votre choix
- Accédez au répertoire
logs/à la racine de votre site
Le répertoire logs/ contient :
- Journal des erreurs PHP, les erreurs générées par le code PHP (le journal le plus souvent nécessaire)
- Journal d'accès, un enregistrement de toutes les requêtes HTTP vers votre site
- Journal des erreurs, les erreurs au niveau serveur (500, 502, etc.)
Lire un journal des erreurs PHP
Une entrée typique d'un journal des erreurs PHP ressemble à ceci :
[03-Jun-2026 14:32:11 UTC] PHP Fatal error: Call to undefined function get_header() in /var/www/sites/yourdomain/public_html/wp-content/themes/mytheme/page.php on line 8
Cela vous indique la date et l'heure, le type d'erreur, une description du problème, ainsi que le chemin du fichier et le numéro de ligne où l'erreur s'est produite.
Types d'erreurs courants
| Type | Gravité | Signification |
|---|---|---|
| Fatal error | Élevée | L'exécution s'est arrêtée. La page ne se chargera pas. |
| Warning | Moyenne | Quelque chose d'inattendu s'est produit, mais l'exécution s'est poursuivie. |
| Notice | Faible | Problème mineur, généralement une violation des bonnes pratiques de codage. |
| Deprecated | Faible | Une fonction utilisée sera supprimée dans une future version de PHP. |
Activer le mode débogage de WordPress
Pour les sites WordPress, l'activation du mode débogage permet d'obtenir des informations d'erreur plus détaillées :
- Connectez-vous via SFTP ou utilisez le Gestionnaire de fichiers dans KPanel
- Ouvrez
wp-config.phpà la racine de WordPress - Ajoutez ou mettez à jour ces lignes :
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Les erreurs seront écrites dans wp-content/debug.log plutôt qu'affichées à l'écran.
Ne laissez pas WP_DEBUG_DISPLAY défini sur true sur un site en production, car cela pourrait exposer des informations sensibles aux visiteurs.
Vérifiez les journaux d'erreurs immédiatement après la mise à jour de WordPress, des extensions ou des thèmes. De nombreux problèmes post-mise à jour laissent des traces claires dans le journal des erreurs PHP.