Configure Remote Debugging With Xdebug On Visual Studio Code Using Docker For Mac

Here are step by step how to enable PHP debugging on Visual Studio Code, this feature is very useful to figure out what’s currently happen on the script execution.

Debugging With Visual Studio Code

In this example I’m going to build my own image from php:7.1-apache Docker image and enable xdebug extension.

The php.ini file only contain xdebug module configuration:


My development environment has dependency to mariadb so I’ll spin up my container using docker-compose.

To run both container (web and mariadb) I’m using the following command:

docker-compose -f docker-compose-xdebug.yml up

Since we are using Visual Studio Code then we must install PHP Debug plugin. If you are still new with Visual Studio Code, you can refer to this link on how to install a plugin.

Now we need to setup launch configuration file in Visual Studio Code. Go to debug menu on left sidebar then click config button.

A window will coming up and open the launch.json file, add these lines into it:

"name": "Listen for XDebug",
"type": "php",
"request": "launch",
"log": true,
"pathMappings": {
"/var/www/html": "/Users/afrimadonidinata/Code/php/my_project"

Here are steps to debugging:

  1. Open the file you want to debug and place breakpoint to specific line
  2. Click start debug button (green right arrow)
  3. Call the php script from browser or CLI



enterprise architect. tech enthusiast. coffee addict.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store