[wp-trac] [WordPress Trac] #49953: Xdebug not working out of the box
WordPress Trac
noreply at wordpress.org
Fri Jan 9 23:38:04 UTC 2026
#49953: Xdebug not working out of the box
-------------------------------------------------+-------------------------
Reporter: Jules Colle | Owner:
| SergeyBiryukov
Type: defect (bug) | Status: closed
Priority: normal | Milestone: 6.8
Component: Build/Test Tools | Version: 5.3
Severity: normal | Resolution: fixed
Keywords: has-patch has-test-info dev- | Focuses:
feedback |
-------------------------------------------------+-------------------------
Comment (by westonruter):
In [changeset:"61461" 61461]:
{{{
#!CommitTicketReference repository="" revision="61461"
Build/Test Tools: Improve Xdebug cross-platform compatibility.
Updates the Xdebug configuration in the local Docker environment to better
support Windows (WSL2) users while maintaining stability for macOS and
Linux.
* Enables `xdebug.discover_client_host` to allow Xdebug to automatically
connect back to the IP address listed in the HTTP request headers,
ensuring the debugger works reliably regardless of specific network
topology.
* Sets `xdebug.client_host` to `host.docker.internal` as a fallback for
`xdebug.discover_client_host`. In WSL2 networking, `localhost` resolves to
the container itself rather than the host machine, preventing the debugger
from connecting to the IDE; `host.docker.internal` correctly routes to the
host machine across platforms.
Follow-up to [60060].
Props SirLouen, jdeep, westonruter.
See #49953.
Fixes #63979.
}}}
--
Ticket URL: <https://core.trac.wordpress.org/ticket/49953#comment:21>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list