Skip to content

Instantly share code, notes, and snippets.

@ojhaujjwal ojhaujjwal/
Last active Aug 13, 2018

What would you like to do?
Configure Xdebug with PHPStorm and Docker for Mac

Add the following xdebug.ini in your docker container:


The most important thing is to set xdebug.remote_connect_back=off and to set xdebug.remote_host=docker.for.mac.localhost . If you want to know why check out this discussion on docker forum.

After that, Configure Docker for Mac integration on PHPStorm.

  1. Go to Preferences -> Build, Execution & Deployment > Docker
  2. Click on + icon somewhere.
  3. Select Docker for Mac
  4. Add path mappings of your container path to local path on Mac.
  5. Click OK.

After that, Add Docker run configuration for the project as

  1. Go to Run > Edit Configurations
  2. Click on + icon somewhere.
  3. Select Docker > docker-compose.
  4. Choose the server that you just created while configuring Docker integration on PHPStorm.
  5. Add the path to the compose file.
  6. If necessary, add services.
  7. Click OK.

After that, Add Debug configuration as

  1. Go to Run > Edit Configurations
  2. Click on + icon somewhere.
  3. Select PHP Remote Debug.
  4. Enter an appropriate name. I choose Xdebug Docker
  5. Check Filter debug connection by IDE key.
  6. Select the docker server.
  7. Add the value debugit(set in xdebug.idekey above) as IDE key(session id).
  8. Click OK.

After that, now start debugging as:

  1. Go to Run > Run
  2. Select the name of Debug configuration. For me, it was Xdebug Docker.
  3. In the toolbar, Click a phone-like icon which says Start listening for PHP Debug connections.

Happy Debugging!!!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.