Le débogage est une étape essentielle du développement web, permettant d’identifier et de corriger les erreurs qui affectent le bon fonctionnement d’un site. Selon l’environnement et les outils utilisés, différentes approches sont nécessaires pour analyser les problèmes et les résoudre efficacement. Cette documentation présente des méthodes adaptées pour faciliter l’identification et la correction des erreurs.
Comment déboguer un site web WordPress
Pour déboguer un site WordPress, il suffit de modifier les constantes suivantes afin d’activer l’affichage des erreurs directement sur le site : WP_DEBUG, WP_DEBUG_LOG et WP_DEBUG_DISPLAY.
Ces paramètres permettent de visualiser les erreurs en temps réel, ce qui est utile en phase de développement. Ils peuvent être modifiés depuis votre espace client Octenium en suivant cette documentation.
Alternativement, il est également possible de modifier directement le fichier de configuration wp-config.php de votre installation WordPress.
Accéder au fichier wp-config.php. Ce fichier se trouve à la racine de votre installation WordPress.
Ajoutez ces lignes avant /* That’s all, stop editing! Happy publishing. */ :
define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false );
Comment déboguer un site web Laravel
Ouvrez le fichier "app.php" situé dans votre projet Laravel sous le répertoire "config/".
Recherchez la ligne suivante et assurez-vous qu’elle est définie sur true :
'debug' => env('APP_DEBUG', true),
Enregistrez les modifications, puis rechargez la page pour afficher les erreurs détaillées dans le navigateur.
Comment déboguer une application Node.js, Ruby ou Python
Pour activer le mode développement, modifiez le fichier .htaccess associé à votre application, qui se trouve dans un dossier différent de celui contenant les fichiers sources.
Le fichier .htaccess se trouve dans le dossier associé à votre domaine, que vous pouvez localiser en accédant à l’option « Domaines » dans votre cPanel, où tous vos domaines et leurs racines de documents sont affichés.
Vous trouverez une section entre des commentaires intitulée “# DO NOT REMOVE. CLOUDLINUX PASSENGER CONFIGURATION”. Il ne faut pas modifier le contenu entre ces lignes. C’est après cette section que vous devrez ajouter le code nécessaire pour activer le mode développement:
PassengerFriendlyErrorPages on PassengerAppEnv development
Si vous souhaitez désactiver le mode développement après avoir corrigé le problème, modifiez simplement ces lignes comme suit :
PassengerFriendlyErrorPages off PassengerAppEnv production
Comment déboguer un site web PHP natif
Si vous souhaitez déboguer les erreurs dans votre site web PHP, vous devez ajouter les lignes suivants sur votre fichier index.php:
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
Ces lignes permettent de rendre visibles toutes les erreurs de niveau PHP, y compris les avertissements et notices, ce qui est essentiel pour comprendre le comportement de votre code.
Une autre technique simple mais efficace pour localiser un problème dans votre code consiste à ajouter des instructions echo à des endroits stratégiques, autour des zones que vous suspectez. L’idée est de tester le code par étapes. En insérant un echo avant et après des segments de code, vous pourrez observer quel bloc fonctionne et quel bloc ne s’exécute pas. Par exemple :
echo 'Test avant le code suspect'; /* Votre code suspect ici */ echo 'Test après le code suspect';
Chaque fois que vous exécutez votre script, si l’echo s’affiche, cela signifie que le bloc de code précédant cet echo a été exécuté. Si l’echo ne s’affiche pas, vous pouvez déplacer l’echo plus près du bloc de code pour isoler précisément l’endroit où le problème survient.
Conclusion
Activer le mode debug est une étape essentielle pour identifier et résoudre les problèmes sur un site web. Une fois le débogage terminé, il est recommandé de désactiver ce mode en production afin d’éviter d’exposer des informations sensibles.