Vim et Xdebug pour débugger votre code PHP

Voici un mini howto pour paramétrer Vim et Xdebug afin de débugger les applications PHP. Je me suis inspiré de différentes sources que vous pouvez trouver à la fin de cette article. Ce mini-howto se base sur une distribution ubuntu.

Pourquoi installer Xdebug et Vim ? Tout simplement car ces deux logiciels représentent une solution légère mais non moins puissante. Il n’y a qu’à taper Vim ou Xdebug pour voir tous les sujets traitant de ces deux logiciels ! De plus ils sont toujours en développement donc constamment adaptés à de nouveaux besoins.

Nous installerons Vim si ce n’est pas déjà fait car Vi possède quelques bugs sous debian et Ubuntu (Vim = Vi IMproved).

1

$sudo apt-get install vim

Si vous souhaitez ajouter la coloration syntaxique, il suffit d’éditer/créer un fichier .vimrc dans votre répertoire utilisateur (cd ~) et d’ajouter syn on.

1
2
3

$ cd ~
$ vi vimrc
(touche insert puis tapez "syn on"enfin touche echap puis MAJ+Z+Z)

Profitons-en pour créer les répertoires pour accueillir les plugins de vim

1
2
3

$ mkdir vim
$ cd vim
$ mkdir plugin

Dans ce répertoire mettez les deux fichiers (debugger.py et debugger.vim) du script DBGp.

Passons à l’installation de Xdebug :

1

$sudo pecl install xdebug

Si cela ne fonctionne vérifiez que vous avez les packages suivants installés : php5-dev php-pear (ceci suppose que vous avez déja installé php). Sinon faites sudo apt-get install php5-dev php-pear.

Une fois Xdebug installé, il faut trouver à quel emplacement est le fichier xdebug.so (si vous n’avez pas de résultats ou que vous êtes sur une autre distribution qu’ubuntu, essayer d’élargir la recherche ci-dessous).

1

$ find /usr/lib/ -name 'xdebug.so'

Notez le chemin complet et ouvrez votre php.ini. Si vous ne savez pas où il se trouve tentez un find /etc/ -name php.ini. Il se peut que vous en ayez plusieurs. Sur mon ordinateur j’ai un php.ini dans apache2 et cli. Je choisie apache2 car cli représente mon interpréteur php en ligne de commande.

À la fin de votre fichier ajoutez les lignes suivantes en remplaçant le chemin de xdebug.so

1
2
3
4
5

[Zend]
zend_extension = /full/path/to/xdebugso
xdebugremote_enable = 1
xdebugremote_port = 9000
xdebugremote_host = localhost

Enfin redémarrez apache :

1

$ sudo /etc/initd/apache2 restart

Pour essayer le débugger lancez vim et appuyez sur F5, vous disposez maintenant de 5 secondes pour pointer avec votre navigateur web sur votre fichier et ajouter à l’url ?XDEBUG_SESSION_START=1.

Les sources :

How to Debug PHP with Vim and XDebug on Linux (dont ce mini howto est largement inspiré)
Ubuntu Forums
How to install Xdebug for PHP5 on Ubuntu 7.10

Sans oublier le site de Vim et de Xdebug