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
On linux since docker 20.04 you can set:
🎉
https://stackoverflow.com/questions/31324981/how-to-access-host-port-from-docker-container/43541732#43541732