Code sur écran d'ordinateur

Installer Xdebug 3 avec PhpStorm sur macOS

Pour cet exemple, nous allons utiliser l’installation de Docker ainsi que de Symfony 5 décrite dans un autre article: Article Docker, Symfony 5

Création d’un alias pour l’IP utilisée

Sur MacOS, il est nécessaire de créer un alias pour l’IP que nous utilisons. Il est commun d’utiliser l’IP:

10.254.254.254

La commande est la suivante:

sudo ifconfig lo0 alias 10.254.254.254

Si vous le voulez à chaque redémarrage de l’ordinateur, grâce à @ralphschindler sur GitHub, c’est très simple à faire en suivant son article https://gist.github.com/ralphschindler/535dc5916ccbd06f53c1b0ee5a868c93

Attention, la configuration de xdebug dans son article concerne la version 2.

La commande est la suivante

sudo curl -o /Library/LaunchDaemons/com.ralphschindler.docker_10254_alias.plist https://gist.githubusercontent.com/ralphschindler/535dc5916ccbd06f53c1b0ee5a868c93/raw/com.ralphschindler.docker_10254_alias.plist

Création du fichier de configuration de xdebug

Avec l’arrivée de la version 3 de xdebug, beaucoup de configurations ont changé de noms.

Dans le dossier docker -> php-fpm, créez un fichier xdebug.ini

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.discover_client_host=off
xdebug.client_host=10.254.254.254
xdebug.client_port=9005
xdebug.idekey=PHPSTORM
xdebug.max_nesting_level=1500

Dans le fichier Dockerfile dans ce même dossier, ajoutez la commande suivante

RUN export XDEBUG_SESSION=PHPSTORM

Configuration de Phpstorm

Créez un nouveau serveur:

Création d'un nouveau serveur dans la configuration de PhpStorm

Et créez un nouveau PHP remote debug avec celui-ci en indiquant la clé « PHPSTORM »

Configuration d'un PHP remote debug avec la clé PHPSTORM

Une fois que cela est fait, il faut aller dans la configuration de xdebug et changer le port pour indiquer 9005 et non 9000

Configuration Xdebug de PhpStorm sur le port 9005

 

Configuration Browser

Pour Firefox installer l’add-on xdebug helper.

Une fois que cela est fait, indiquez que vous utilisez PHPSTORM dans la configuration du plugin

Configuration du plugin navigateur avec la clé PHPSTORM
firefox

Extension Xdebug helper dans Firefox