XDebug 3 only started working out of the box with PhpStorm version 2020.3
Reference article - Configure Xdebug
The list of changes from XDebug 2 to 3 are available here for reference - Upgrade Guide
Go to PhpStorm -> Settings -> Languages & Frameworks -> PHP -> Servers
- Click "+"
- Name
docker-cli
(Same as serverName under PHP_IDE_CONFIG environment variable) - Host
_
- Default 80
- Debugger Xdebug
- Check the checkbox next to "Use path mappings"
- Modify the absolute path on the server to
/var/www/html
- Add breakpoints file
- In PhpStorm click the icon to "Start Listening for PHP Debug connections"
- Run in the docker file -
docker-compose run php-container php test.php
- Check firewall or selinux if on linux
- The configuration
host.docker.internal
only became available under Mac and Windows with Docker version20.04
@WonRhee Install the „Xdebug Helper“ browser extension and configure it with the settings for your IDE.
The extension will set the request params for you to enable or disable php debugging.