xdebug.md

Debugging with Docksal, Xdebug and PhpStorm

xdebug extension is disabled by default as it causes about 20% performance hit.

Prerequisites

• PHPStorm

• Xdebug Helper extension for Chrome

  You can also pick from the list of options for other browsers

Setup

1. Set environment variable on the cli service

   cli:
     ...
     environment:
       - XDEBUG_ENABLED=1
     ...

2. Update container configuration with fin up

3. Open your project in PHPStorm

4. Set a breakpoint wherever you like

5. Click on the Start Listening for PHP Debug Connections button in PHPStorm

   

6. Click on Debug in Xdebug Helper in Chrome

   

7. Click on Accept in the Incoming Connection From Xdebug dialogue in PHPStorm

   

Happy debugging!

Resources

• Zero-configuration Web Application Debugging with Xdebug and PhpStorm