Docker on Windows: Xdebug for PhpStorm ¶ Docker for Windows requires a well known IP address in order to connect to the host operating system.

1. It is possible to run PHP cli without a docker-compose file, I have found it is easier to set up PhpStorm using this intermediate step. PhpStorm has several preconfigured Docker containers, source: Github - JetBrains / phpstorm-docker-images; Docker hub - PhpStorm; They can be used as follows: Php 7.3 CLI and XDebug 2.7.
2. In this video we're gonna go through two methods of making PhpStorm run PHP code on Docker containers. In addition we're making sure that Xdebug is working s.
3. Docker+php-fpm+xdebug (on Linux) + PHPStorm (on Windows) 6th April 2021 docker, php, phpstorm, xdebug. I have docker installed on my Linux host and raised a container with php-fpm and xdebug. Phpstorm is installed on Windows server. The project is hoisted through gitlab.

Docker for Windows requires a well known IP address in order to connect to the host operatingsystem.

Table of Contents

• Prerequisites
• Configuration

Ensure you know how to customize php.ini values for the Devilbox and have a rough understandingabout common Xdebug options.

On Windows you will have to manually retrieve the IP address to which Xdebug should connect tovia xdebug.remote_host.

When you have done no custom configuration in your Virtual Switch manager, Docker for Windows willuse the DefaultSwitch automatically.

Windows: Virtual Switch Manager example screenshot

1. Open command line

2. Enter ipconfig

3. Look for the IP4 address in DefaultSwitch (e.g.: 192.168.0.12)

Important

192.168.0.12 is meant as an example and will eventually differ on your system.Ensure you substitute it with the correct IP address.

For the sake of this example, we will assume the following settings and file system paths:

Directory	Path
Devilbox git directory	/home/cytopia/repo/devilbox
HOST_PATH_HTTPD_DATADIR	./data/www
Resulting local project path	/home/cytopia/repo/devilbox/data/www
Selected PHP version	5.6
DockerNAT IP address	192.168.0.12
Virtual Switch IP address	192.168.0.12

The Resulting local project path is the path where all projects are stored locally on yourhost operating system. No matter what this path is, the equivalent remote path (inside the Dockercontainer) is always /shared/httpd.

Important

Remember this, when it comes to path mapping in your IDE/editor configuration.

1. Ensure Xdebug port is set to 9000

2. Set path mapping

Create a new PHP server and set a path mapping. This tutorial assumes your local Devilbox projectsto be in ./data/www of the Devilbox git directory:

Important

Recall the path settings from the Assumption section and adjust if your configuration differs!

3. Ensure DBGp proxy settings are configured

Note

The following example show how to configure PHP Xdebug for PHP 5.6:

Create an xdebug.ini file (must end by .ini):

Copy/paste all of the following lines into the above created xdebug.ini file:

Important

Ensure you have retrieved the correct DockerNAT IP address as stated in the prerequisites section above!

Note

Phpstorm Xdebug Ssh

Host os and editor specific settings are highlighted in yellow and are worth googling to get a better understanding of the tools you use and to be more efficient at troubleshooting.

Xdebug 3 Docker Phpstorm

Restarting the Devilbox is important in order for it to read the new PHP settings.Note that the following example only starts up PHP, HTTPD and Bind.

See also

Phpstorm Docker Xdebug Not Working

Stop and Restart (Why do docker-composerm?)