Disclosure: I am the creator of Stratos , a native macOS local PHP/Laravel stack.
If you have ever spent 45 minutes trying to figure out why an Xdebug breakpoint silently never hits inside Docker Desktop for Mac, the culprit is almost never your PHP code. It is the translation layer between the Linux container and macOS.
Here is why step-debugging breaks so often in Docker—and how running native Apple Silicon/Universal PHP-FPM ( 8.1 – 8.5 ) eliminates host.docker.internal and pathMappings friction completely.
Why Docker Xdebug Breaks on macOS
When PHP runs inside a Linux container, Xdebug initiates an outbound TCP connection back to your IDE on port 9003 .…