Remote Debugging PHP in Visual Studio Code with XDebug

Remote Debugging PHP in Visual Studio Code with XDebug prereqs:
1) This post assumes you already have a working xdebug install
2) vscode

How to get Xdebug working with Visual Studio Code?

  • Open vscode
  • Goto the extensions tab (the last icon on the left pane)
  • Search for ‘PHP Debug’
  • Click install
  • Next Click restart
  • Finally, Click the debug tab (this looks like a bug with a line through, usually its the icon above the extensions tab in the left pane)
  • Make sure that “listen to xdebug” is selected
  • Click the ‘play’ icon (or press F5) to start the debugging session

Setting Up Remote Debugging PHP in Visual Studio Code with XDebug – Paths

  • Click the gear-icon
  • Add the following to the “Listen for XDebug” section

"stopOnEntry": true,
"pathMappings": {
    "/var/www/vhosts/": "${workspaceRoot}/",
}

The exact path mappings will depend on your project
Click the ‘play’ icon (or press F5) to start the debugging session

PHP Step Debugging

To set a breakpoint, click on the gutter to the left of the line number

Leave a Reply