Click 'Ignore' on that dialog, set up the server mapping, and try again, and you should get a proper debug session. If youre using WSL2 and running PhpStorm on the Windows side, PhpStorm cant use docker-compose from WSL2, so configure Docker Desktop in Settings.

Then click 'Listen for debug connections' in the toolbar, and run your script a dialog box should pop up showing the 'Server name:' and 'Server port:' it is trying to match, as well as confirming the remote file path. To find out what details you need to set up, go into 'Settings > Languages and Frameworks > PHP > Debug', enable 'Force break at the first line when no path mapping specified', and make sure 'Ignore external connections through unregistered server configurations' is not ticked. This option has to be enabled to synchronize our project files with a virtual machine in Docker. We need to enable sharing on a disk where our project is located. Another one important setting for Docker is enabling drive sharing. For instance, if you SSH to 192.168.42.42 on the standard SSH port (22), you would enter 'Host: 192.168.42.42', and 'Port: 22'. PhpStorm will use port 2375 over TCP to communicate with Docker. For CLI scripts, the info to put in here will be based on your connection to the server where the CLI script runs. Normally, you would enter a URL into 'Host' and set 'Port' to the HTTP port, e.g. Also, PhpStorm automatically switches to Git from WSL for projects that are opened when you use the \wsl$ path.įor more information about working with Git in PhpStorm, refer to Git.You need to set up a 'server' configuration in 'Settings > Languages and Frameworks > PHP > Servers' which maps the paths as seen on the server to the paths in your project. If Git is not installed on Windows, PhpStorm searches for Git in WSL and uses it from there. PhpStorm supports Git from the Windows Subsystem for Linux 2 (WSL2), which is available in Windows 10 version 2004. In the Select Path dialog that opens, select the folder in the WSL file system that contains the project to open, or type the path to the \wsl$ project location manually. In PhpStorm, you can directly open a project stored in the WSL file system and work with it like with any other project.Ĭlick Open on the Welcome screen or select File | Open from the main menu. Open a project stored in the WSL file system You can appoint the created interpreter for all common tasks: executing scripts or Composer commands, running PHP Quality tools, and so on. Sudo apt install php php-mbstring php-xml php-zip php-curl php-xdebugĬonfigure a WSL-based remote interpreter as described in Configure remote PHP interpreters. Open Windows PowerShell as Administrator and run In this case, you need to do the following: Upon the first launch, the system may prompt you to enable the Windows optional feature. In this case, you need to update your WSL distribution. Note that PhpStorm does not support legacy WSL, which you may have installed before upgrading your system to the build 16299.15 or later of Windows 10. Follow these instructions to switch the distributive. To work with WSL 2, your Windows version should be 10 build 18917 or later. See the official guide Install the Windows Subsystem for Linux for instructions. Configure WSLĭownload and install a WSL distribution (for instance, Ubuntu) from Microsoft Store.įor this step, be sure to use at least Windows 10 or later with the latest “Fall Creators Update” (minimum version 1709, build 16299.15). Currently, it supports several Linux distributions, such as Ubuntu, OpenSUSE, and SLES. WSL ( WSL 2) – Windows Subsystem for Linux – is a compatibility layer for running Linux binary executables natively on Windows 10 and later.

Phpstorm docker wsl2