#

Using Xdebug with Herd

Herd includes support for Xdebug, a popular and powerful debugger for PHP. The free version of Herd ships with Xdebug's PHP extensions out-of-the-box, but you need to manually enable the extension when you need it.

[!NOTE]
Looking for an even easier way to debug your applications? Check out Herd Pro's Xdebug integration. It can automatically enable Xdebug if you send the Xdebug request header via the official Xdebug browser extensions.

#

Enabling Xdebug manually

In order to activate Xdebug, you need to add the appropriate PHP extension to your php.ini file. The extensions are located in the Herd application bundle, which you can find in your Applications folder.

After you have located the correct version of Xdebug, you should append the necessary configuration to your php.ini file. For example, the setup for PHP 8.3 on an Apple Silicon Mac looks like this:

zend_extension=C:\Users\<USER>\.config\herd\bin\xdebug\xdebug-8.3.dll
xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.start_upon_error=yes

After you have saved the changes to your php.ini file, you need to restart Herd's services from the menu bar icon, or by running the following command in your terminal:

herd restart

For more information about the available Xdebug settings, please refer to the official Xdebug documentation.