Installer l'extension PHP XDebug sur Debian

Ce guide est testé sur:

• Debian 6.0 Squeeze
• Debian 7.0 Wheezy
• Ubuntu 10.04 Lucid Lynx
• Ubuntu 10.10 Maverick Meercat
• Ubuntu 11.04 Natty Narwal

Prérequis

Ce guide nécessite:

• une installation fonctionnelle de PHP, telle que décrite par Installer PHP-FPM sur Debian.

Installation depuis les dépôts

Installez le logiciel:

command apt-get -y install php5-xdebug

Rechargez la configuration:

test -e '/etc/init.d/php5-fpm' && command service 'php5-fpm' 'restart'
test -e '/etc/init.d/apache2' && command service 'apache2' 'force-reload'

Installation manuelle

Si le paquet Debian n'existe pas, installez l'extension manuellement.

Détectez le chemin des fichiers de configuration des extensions PHP:

MODS_CONF_PATH='/etc/php5/conf.d'
test -d '/etc/php5/mods-available' \
  && MODS_CONF_PATH='/etc/php5/mods-available'

Préparation de l'environnement

installez les logiciels nécessaires:

command apt-get install php5-dev make php-pear

Mettez à jour PEAR:

command pear channel-update pear.php.net
command pear upgrade PEAR

Mettez à jour PECL:

command pecl channel-update pecl.php.net
command pecl upgrade

Mise en place du logiciel

Installez l'extension:

command pecl install 'xdebug'

Détectez l'emplacement de l'extension:

XDEBUG_SO="$(command find '/usr/lib/php5/' -name 'xdebug.so' \
    | command head -n 1)"

Activez l'extension:

echo "; configuration for php XDebug module
; priority=20
zend_extension=${XDEBUG_SO}" > "${MODS_CONF_PATH}/xdebug.ini"
test -n "$(command -v php5enmod)" && command php5enmod 'xdebug'

Rechargez la configuration:

test -e '/etc/init.d/php5-fpm' && command service 'php5-fpm' 'restart'
test -e '/etc/init.d/apache2' && command service 'apache2' 'force-reload'

Finalisation

La procédure d'installation manuelle recommande:

• la mise en place d'alertes lorsque de nouvelles mises à jour PEAR et PECL sont disponibles, comme décrit par Surveiller les mises à jour PEAR.

Remerciements

• Merci aux développeurs de XDebug (en).