Formation PUB020 : WordPress, 2019 Aménager notre environnement pour travailler efficacement

Déboguer un programme avec PhpStorm


L'utilisation d'un débogueur est, de loin, la meilleure technique pour déboguer un programme. Il sera ainsi possible de vérifier la valeur d'une variable à un instant donné, de vérifier quelles lignes de code sont exécutées, etc. et ce sans avoir à modifier le code pour afficher des messages de débogage.

Pour configurer le débogueur de PhpStorm avec AMPPS :

  • Assurez-vous que l'extension Xdebug soit correctement activée et que xdebug.remote_enable soit à 1 (voir la fiche Activer XDebug sous AMPPS).
  • Vérifiez le port de débogage configuré dans le fichier php.ini, à la ligne xdebug.remote_port. À titre indicatif, sous EasyPHP, le port configuré par défaut est 9009. Sous AMPPS, il n'y en a pas. Si vous ne trouvez pas cette configuration, le port à utiliser est le 9000. Assurez-vous que ce même numéro de port est utilisé dans la configuration Languages & Frameworks / PHP / Debug, dans la section Xdebug, à la ligne Debug port.

    Configurations de débogage

  • Pour vérifier si les configurations sont correctes, allez dans le menu Run / Web Server Debug Validation.

    • Entrez le chemin physique de votre site (ex : sous Windows - C:\Program Files\Ampps\www\monsite, sous Mac - /Applications/AMPPS/www/monprojet).
    • Entrez l'URL de votre site (ex : http://127.0.0.1/monprojet).
    • Cliquez sur Validate.

    Vous ne devriez voir que des crochets verts.

    Validate Debugger Configuration
  • Vous êtes maintenant prêt à lancer le débogage. Ajoutez un point d'arrêt dans votre code (sur une ligne PHP et non sur une ligne qui ne contient que du HTML) en cliquant dans la marge gauche puis lancez le débogage en cliquant sur l'icône de débogage.

    Icône pour déboguer site

  • Le programme s'arrêtera dès qu'il atteindra un point d'arrêt. Vous verrez dans la fenêtre de débogage la valeur des différentes variables. Vous pourrez poursuivre l'exécution du site ligne à ligne (flèches au-dessus de la zone Variables) ou encore poursuivre l'exécution jusqu'à ce qu'un autre point d'arrêt soit rencontré (flèche verte à gauche).

    Fenêtre de débogage

  • La liste des variables apparaît par défaut mais il est également possible d'en ajouter. On pourrait, par exemple, demander au débogueur d'évaluer une expression.

▼Publicité

Pour plus d'information

« The Debugging Golden Rule ». Dev. https://dev.to/gonedark/the-debugging-golden-rule-7cb

« Debugging with a PHP Web Application Debug Configuration ». PhpStorm. https://www.jetbrains.com/help/phpstorm/2016.2/debugging-with-a-php-web-application-debug-configuration.html

« Configuring Xdebug ». PhpStorm. https://www.jetbrains.com/help/phpstorm/2016.2/configuring-xdebug.html

« Xdebug extension for PHP | Documentation ». Xdebug. https://xdebug.org/docs/all_settings

« Troubleshooting PhpStorm debugging ». JetBrains. https://confluence.jetbrains.com/display/PhpStorm/Troubleshooting+PhpStorm+debugging

Dernière révision le 11 février 2020
Merci de partager !

Site fièrement hébergé chez A2 Hosting.

Soumettre