11.28 Installer Xdebug sur macOS Sequoia

Lorsque vous travaillez sous Mac avec un outil tel que AMPPS pour effectuer du développement Web local, Xdebug n'est pas installé par défaut.

Je vous propose une technique pour l'installer manuellement.

Cette technique est plus simple que celle proposée par l'assistant de Xdebug.

• Assurez-vous que Homebrew soit installé. Vous pouvez suivre les instructions ici : « Installation de Homebrew ».
• Installez autoconf :
  Terminal

  brew install autoconf

• Vous aurez besoin de PECL (PHP Extension Community Library) pour installer Xdebug. Sous AMPPS, l'installation est déjà faite. Si vous travaillez dans un autre environnement, vous pouvez effectuer l'installation à l'aide des instructions sur cette fiche : « Installer PEAR et PECL ».
• Dans le terminal, placez-vous dans le dossier qui contient la commande PECL. Par exemple, sous AMPPS (remplacez xx par la version de PHP) :
  Terminal

  cd /Applications/AMPPS/apps/phpxx/bin

• Pour installer Xdebug  :
  Terminal

  sudo ./pecl install xdebug

• Attention : si vous obtenez un message du genre « Xdebug requires Zend Engine API version 320190902. The Zend Engine API version 420220829 which is installed, is newer. », c'est que votre système utilise la mauvaise verson de PHP.

  Pour corriger la situation :

  • Affichez une page Web qui utilise phpinfo().
  • Retrouvez la ligne Loaded Configuration File. Prenez en note le chemin du fichier php.ini. Ex : /Applications/AMPPS/apps/php82/etc/php.ini 
  • Lancez cette commande en ajustant le chemin trouvé ci-haut.
    
    Terminal

    sudo ./pecl config-set php_ini /Applications/AMPPS/apps/php82/etc/php.ini

  • Ajustez également le chemin pour accéder au fichier exécutable php. 
    Terminal

    sudo ./pecl config-set bin_dir /Applications/AMPPS/apps/php82/bin

  • Vous pouvez désormais installer Xdebug.
    Terminal

    sudo ./pecl install xdebug

• Lorsque l'installation est complétée, prenez en note l'emplacement du fichier, par exemple :

  /Applications/AMPPS/apps/php82/lib/extensions/no-debug-non-zts-20220829/xdebug.so

  Vous aurez besoin de ce chemin pour poursuivre l'installation.

Pour plus d'information

« Installation Wizard ». Xdebug. https://xdebug.org/wizard