Xdebug est idéal pour déboguer votre code PHP en temps réel. Il existe plusieurs façons de l'installer sur RHEL 8 / CentOS 8, mais la plus simple et la plus directe utilise des packages trouvés directement dans les dépôts de RHEL.
Dans ce didacticiel, vous apprendrez :
- Comment installer les dépendances
- Comment installer Xdebug avec PECL
- Comment configurer PHP pour utiliser Xdebug
- Comment s'assurer que Xdebug est chargé

Configuration logicielle requise et conventions utilisées
Catégorie | Exigences, conventions ou version du logiciel utilisée |
---|---|
Système | RHEL 8/CentOS 8 |
Logiciel | PHP Xdebug |
Autre | Accès privilégié à votre système Linux en tant que root ou via le sudo commande. |
Conventions | # - nécessite que les commandes linux données soient exécutées avec les privilèges root soit directement en tant qu'utilisateur root, soit en utilisant sudo commande$ – nécessite que les commandes linux données soient exécutées en tant qu'utilisateur normal non privilégié |
Installer les dépendances
Avant de pouvoir faire quoi que ce soit, vous allez devoir installer quelques dépendances PHP pour pouvoir télécharger et compiler Xdebug. Ce sont probablement des choses que vous voudriez de toute façon sur une machine que vous utilisez pour développer avec ou héberger PHP. Ils sont tous dans les référentiels RHEL / CentOS par défaut, alors allez-y et installez-les avec dnf
.
# dnf install php php-devel php-pear
Installer Xdebug avec PECL
Ensuite, vous pouvez installer xdebug avec PECL. Il existe plusieurs autres façons de l'obtenir, mais actuellement, elles ne semblent pas correspondre correctement. Cela pourrait changer à l'avenir, mais PECL fonctionnera certainement.
# pecl install xdebug
La configuration peut prendre quelques minutes, une fois que vous avez terminé, vous aurez le module PHP Xdebug.
Configurer PHP pour utiliser Xdebug
Pour utiliser votre nouveau module Xdebug, vous devrez l'ajouter à votre configuration PHP. RHEL 8 utilise une série de fichiers .ini
plus petits fichiers pour ajouter des modules à la configuration complète de PHP. Ils se trouvent dans /etc/php.d
. Créez-en un nouveau pour Xdebug dans /etc/php.d/30-xdebug.ini
, et ouvrez-le avec votre éditeur de texte préféré.
Dans la configuration du module Xdebug, placez les paramètres suivants. De toute évidence, le plus important est la première ligne qui pointe vers le module lui-même.
zend_extension="/usr/lib64/php/modules/xdebug.so"
xdebug.remote_log="/tmp/xdebug.log"
xdebug.profiler_enable = 1
xdebug.remote_enable=on
xdebug.remote_port=9000
xdebug.remote_autostart=0
xdebug.remote_connect_back=on
xdebug.idekey=editor-xdebug
Lorsque vous avez terminé, enregistrez la configuration.
Ensuite, vous devrez redémarrer votre serveur exécutant PHP. Pour Apache, utilisez ce qui suit.
# systemctl restart http
Si vous utilisez PHP-FPM et Nginx, utilisez :
# systemctl restart php-fpm
Si, par hasard, cela n'a pas fonctionné à l'étape suivante, redémarrez votre ordinateur.
Assurez-vous que Xdebug est chargé
Il est simple de voir si Xdebug fonctionne et est chargé en PHP. En supposant que votre racine Web est /var/www/html
, modifiez ou créez un nouveau fichier à /var/www/html/index.php
.
Dans le fichier, exécutez le phpinfo()
méthode pour imprimer une tonne d'informations sur la configuration PHP de votre système.
<?php phpinfo(); ?>
Ouvrez votre navigateur et accédez à cette page. Vous devriez pouvoir rechercher xdebug
et trouvez un bloc détaillant les informations sur votre installation. Si vous voyez le bloc, Xdebug est chargé et fonctionne.
Conclusion
Voilà! Xdebug est installé et configuré sur votre système. Utilisez PECL pour le maintenir à jour et vous ne devriez rencontrer aucun problème.