Debug Overview

The Debug integration allows debugging on your local development server and also on a remote server.

Please refer to Xdebug for more details on debugging configurations. Xdebug is the backend of PHP Tools debugging integration.

Initial setup


  • PHP 5.6 or newer with compatible Xdebug extension


  • Ensure Xdebug is properly configured: run php --version and check the last line is with Xdebug.
  • Ensure php.ini states the following directives:
xdebug.remote_enable = 1
xdebug.remote_autostart = 1 // or append `XDEBUG_SESSION_START=1` parameter to the URL of page you want to debug


The debugging features are the following:

  • Stepping by line, step in, step out.
  • Placing breakpoints, conditional breakpoints, break on hit count.
  • Logging breakpoint hit into 'Debug console'.
  • Breaking on exceptions, warnings and errors.
  • Specifying non-user files (exceptions won't break debugging, stepping through).
  • Watch tool tips.
  • Listing locals and superglobals.
  • Editting variable or property value, handling long string values efficiently.
  • Long arrays watch efficiently.
  • Debug watch expands objects and arrays.
  • Evaluating code in 'Debug console'.
  • Debug launch profiles.
  • Built-in web development server.
  • Debugging of 'PHP Unit' test cases.


Related links