Skip to end of metadata
Go to start of metadata


This tutorial explains how to install Xdebug extension to your web server and prepare it to be used for debugging with PhpStorm IDE.

Using HomeBrew

HomeBrew is a package manage for OS X that helps you to easily install commonly used packages. HomeBrew can be used to install and upgrade your version of PHP, and can also be used to easily install Xdebug:

brew install php<version number>-xdebug

Where <version number> is the version number (without the .) that you are using. For example, for PHP 5.6 use:

brew install php56-xdebug

This will install and enable Xdebug in your php.ini file. You can check that Xdebug has been install by using the command

php -v

You should see a line similar to

  with Xdebug v2.2.5, Copyright (c) 2002-2014, by Derick Rethans

Downloading, Installing and Configuring the Xdebug Extension

  1. Download the Xdebug extension compatible with your PHP version (mind the PHP version number and thread-safe/non-thread-safe option) from the official site. These instructions are based on the latest version in the 2.x release of Xdebug.
  2. Copy the extension file to your web server in a location that is accessible by the web server.
  3. Add the following lines at the end of your php.ini file:


    Since PHP 5.3, you always need to use the 'zend_extension', and NOT 'zend_extension_ts', 'zend_extension_debug' or 'extension'.


    The value of 'xdebug.remote_host' can be a host name (e.g. localhost) or an IP address.


    The value of 'xdebug.remote_port' is usually 9000. It is default value in Xdebug and PhpStorm. Ensure that the specified port is opened on your client machine.

    For additional information check

  4. Restart your web server
  5. Check your installation:
    1. Execute in the terminal

    2. Or create a file with the following content:

    3. Open a page corresponds to this file and check phpinfo() output. It should contain Xdebug section:

Once you've installed and configured Xdebug, you can use the Validating Your Debugging Configuration tool to confirm that the configuration of Xdebug and PhpStorm are compatible. 

  • No labels