[wp-trac] [WordPress Trac] #63979: WordPress Core setup does not configure XDebug properly

WordPress Trac noreply at wordpress.org
Fri Jan 9 23:38:04 UTC 2026


#63979: WordPress Core setup does not configure XDebug properly
------------------------------+-----------------------
 Reporter:  jdeep             |       Owner:  SirLouen
     Type:  defect (bug)      |      Status:  closed
 Priority:  normal            |   Milestone:  6.9.1
Component:  Build/Test Tools  |     Version:
 Severity:  normal            |  Resolution:  fixed
 Keywords:  commit            |     Focuses:
------------------------------+-----------------------
Changes (by westonruter):

 * status:  reviewing => closed
 * resolution:   => fixed


Comment:

 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/63979#comment:16>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform


More information about the wp-trac mailing list