🎥 Comment configurer Xdebug avec PHPStorm en 5 minutes 🛠

Dans ce tutoriel, nous allons apprendre à configurer Xdebug avec PHPStorm en seulement 5 minutes. Suivez ces étapes pour installer, activer et personnaliser Xdebug dans votre environnement PHP, tout en maximisant votre productivité en développement.

Étape 1 : Vérifiez votre installation PHP

Avant toute chose, vous devez confirmer quelle version de PHP est utilisée par votre projet.

1. Créez un fichier phpinfo.php :Placez-le dans votre répertoire web accessible et ouvrez-le dans un navigateur.
2. Cherchez "Xdebug" :
   Si Xdebug n'est pas mentionné, cela signifie qu'il n'est pas encore installé.

<?php

phpinfo();

Étape 2 : Installez Xdebug

L'installation de Xdebug varie selon votre système d'exploitation :

Sous Linux (basé Debian/Ubuntu) :

1. Ouvrez un terminal.
2. Installez Xdebug avec la commande suivante :

sudo apt-get install php-xdebug

Sous Windows ou macOS :

Consultez la documentation officielle de Xdebug pour des instructions spécifiques. Téléchargez et installez l'extension compatible avec votre environnement.

Étape 3 : Configurez Xdebug dans php.ini

Une fois Xdebug installé, vous devez l’activer et le configurer.

• Ouvrez votre fichier de configuration PHP principal. Vous pouvez trouver son emplacement via phpinfo() (variable Loaded Configuration File).
• Ajoutez ou modifiez les lignes suivantes dans votre fichier php.ini :

zend_extension=xdebug.so

xdebug.mode=debug

xdebug.start_with_request=yes

xdebug.client_port=9003

• Sauvegardez les modifications et redémarrez votre serveur web ou votre environnement PHP (par exemple, apache2, php-fpm, ou similaire).

Étape 4 : Vérifiez l'installation de Xdebug

Revenez sur votre fichier phpinfo.php et recherchez "Xdebug". Vous devriez voir une section dédiée à Xdebug, confirmant qu’il est activé.

Étape 5 : Configurez Xdebug dans PHPStorm

1. Ouvrez les paramètres de PHPStorm (Ctrl+Alt+S ou Cmd+,).
2. Naviguez jusqu’à :
   Languages & Frameworks → PHP → Debug.
3. Définissez les paramètres :
   • Port : 9003 (par défaut pour Xdebug 3).
   • Validez que le débogueur est bien activé.
4. Ajoutez une configuration de débogage :
   • Allez dans Run → Edit Configurations → Add New Configuration → PHP Remote Debug.
   • Assurez-vous que le serveur et les chemins d’accès sont correctement définis.

Étape 6 : Testez le débogueur

1. Placez un point d'arrêt dans votre code source.
2. Exécutez votre script avec le débogueur actif.
3. PHPStorm devrait automatiquement intercepter l’exécution et afficher les informations de débogage.

Options supplémentaires pour personnaliser Xdebug

Xdebug propose plusieurs modes pour différents usages :

• debug : Pour le débogage pas à pas.
• coverage : Pour analyser la couverture de code.
• develop : Pour des outils de développement (comme des vardump améliorés).

Exemple de configuration pour le php.ini :

xdebug.mode=develop,debug

xdebug.client_host=127.0.0.1

Conclusion

Avec cette configuration, vous êtes prêt à utiliser Xdebug dans PHPStorm. Cela simplifie considérablement le processus de débogage, rendant vos sessions de développement plus efficaces et précises. Si vous avez des questions ou des problèmes, n’hésitez pas à rejoindre des communautés comme les serveurs Discord dédiés au développement PHP.

Obtenir de l'aide

Pour obtenir de l'aide, vous pouvez accéder au serveur Discord pour une entraide par chat.