[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