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).
- Installer xdebug en tapant dans une console:
sudo apt-get install php-xdebug - 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 - Sous Eclipse maintenant, installer PHP Development Tools (PDT) via Help > Install new software.
-
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.
-
Cliquer sur la flèche déroulante Debug, puis sélectionner Debug configurations…
-
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:
-
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 -
De retour sur la boite de configuration précédente, cliquer sur Browse et sélectionner le fichier
index.php:
-
Passer sur l’onglet Debugger et sélectionner XDebug dans le popup déroulant Server Debugger:
-
Cliquer sur Apply puis fermer la boite de dialogue.