Debugger WordPress sous Eclipse

Lorsque l’on cherche à comprendre le fonctionnement de WordPress, que l’on commence à vouloir écrire ses propres hooks (filtres et actions), on éprouve rapidement le besoin d’un environnement permettant d’exécuter le code pas à pas et d’afficher le contenu des variables.

J’explique ici comment configurer l’IDE Eclipse à cette fin.

Je suis partie de la version suivante d’Eclipse, déjà installée, mais la procédure devrait marcher pour toute autre version : Eclipse IDE for Java Developers – Version: Luna Service Release 2 (4.4.2).

  1. Installer xdebug en tapant dans une console:
    sudo apt-get install php-xdebug
    
  2. Modifier le fichier de configuration d’Apache, /etc/php/7.0/apache2/conf.d/20-xdebug.ini, comme suit:
    zend_extension=xdebug.so
    xdebug.remote_enable=On
    xdebug.remote_host="localhost"
    xdebug.remote_port=9000
    xdebug.remote_handler="dbgp"
    

    Et redémarrer le serveur Apache:

    sudo service apache2 restart
    
  3. Sous Eclipse maintenant, installer PHP Development Tools (PDT) via Help > Install new software.

  4. Créer un nouveau PHP Project en faisant pointer les sources à la racine de son site WordPress. Attention de vérifier que vous avez bien les droits d’écriture dans ce répertoire.

  5. Cliquer sur la flèche déroulante Debug, puis sélectionner Debug configurations…

  6. Dans le panneau de gauche, sélectionner PHP Web Application, et cliquer sur l’icône New launch configuration. La fenêtre suivante apparaît, saisir le nom de la configuration de debug:

  7. Cliquer sur New, configurer le serveur Web comme suit, et cliquer sur Finish:
    Name: nom du serveur
    Debugger: sélectionner XDebug
    Base URL: saisir l’URL cible du serveur WordPress local
    Local Web Root: saisir le chemin vers le répertoire local des fichiers du serveur WordPress

  8. De retour sur la boite de configuration précédente, cliquer sur Browse et sélectionner le fichier index.php:

  9. Passer sur l’onglet Debugger et sélectionner XDebug dans le popup déroulant Server Debugger:

  10. Cliquer sur Apply puis fermer la boite de dialogue.

Bibliographie