Chez ACSEO, les bugs n’existent pas… Ou presque 🙂

Cependant, quand ces petits insectes pas très sympa se présentent, nous savons les reCevoir. Découvrez dans cet article comment mettre en place XDebug avec l’IDE Atom pour enfin reprendre le contrôle de votre côte et éviter les var_dump() hasardeux.


Less central control over education will encourage schools to essay help chat innovate, attract talented teachers, and strive for excellence

Dans cet article, nous vous montrerons comment installer et paramétrer XDebug et le module Debug dans Atom. Si votre environnement de développement est différent, vous arriverez facilement à adapter le contenu de cet article pour parvenir à vos fins.

Installation de XDebug

L’installation de XDebug n’est pas très compliquée.

sur Mac, avec brew :

Repérez d’abord la version de PHP que vous utilisez avec :

$ php -v

Puis en fonction de votre version PHP, lancer l’installation de XCode appropriée. Exemple pour PHP 5.6 :

$ brew install php56-xdebug

sur Linux, avec une debian Jessie :

$ apt-get install php5-xdebug

Maintenant que XDebug est installé, vous devriez voir l’extension installée en tapant php -v

$ php -v
PHP 5.6.29 (cli) (built: Dec  9 2016 07:03:56) 
Copyright (c) 1997-2016 The PHP Group
Zend Engine v2.6.0, Copyright (c) 1998-2016 Zend Technologies
with Xdebug v2.5.0, Copyright (c) 2002-2016, by Derick Rethans

Pour préparer la suite, et pour un débug local, nous paramètrerons l’extension xdebug en éditant le fichier xdebug.ini avec les informations suivantes :


xdebug.remote_enable=1
xdebug.remote_host=127.0.0.1
xdebug.remote_connect_back=1    # Not safe for production servers
xdebug.remote_port=9000
xdebug.remote_handler=dbgp
xdebug.remote_mode=req
xdebug.remote_autostart=true

Installation de PHP-Debug

Nous allons maintenant installer le package PHP-Debug dans Atom.  Pour installer ce package, vous pouvez passer par la ligne de commande vi (apm) ou via le menu de l’IDE (Atom > Preferences > Install)

Si tout se passe bien, le package sera correctement installé et vous pourrez commencer à mettre des points d’arrêts dans votre code. Pour cela :

  • faites un clic droit sur la ligne souhaitée, puis PHP-Debug > Toogle Breakpoint
  • Utilisez les raccourcis prévus à cet effet (Visible dans Package > PHP-Debug, Alt+F9 sur Mac)

Vous verrez alors la ligne se surligner en vert, comme dans l’exemple ci-dessous.

xdebug

Il est temps de débugger ! Mais pour cela, nous allons avoir besoin d’une extension dans notre navigateur.

Utilisez votre navigateur pour débugger

Si vous utilisez Chrome, Vous pouvez utilisez l’extension XDebug Helper, et The easisest Xdebug pour Firefox. Grâce à ces extensions, vous pourrez activer / désactiver Xdebug pour l’exécution de votre page.

Une fois Xdebug activé, rafraîchissez votre page. Si tout va bien, votre page ne devrait pas s’afficher, et rester en chargement. Cela est normal. En basculant sur Atom, vous vous apercevrez alors que l’exécution de votre script s’est arrêtée au premier point d’arrêt. Le panneau d’information de XDebug vous fournira alors un certain nombre d’informations utiles :

  • La stack trace d’appel
  • Les variables de contexte
  • Les variables que vous souhaitez suivre
  • La liste des points d’arrêts

Vous disposez maintenant des outils pour pouvoir débugger facilement et proprement votre code.