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

WordPress Trac noreply at wordpress.org
Mon Sep 15 13:16:03 UTC 2025


#63979: WordPress Core setup does not configure XDebug properly
------------------------------+-----------------------------
 Reporter:  jdeep             |      Owner:  (none)
     Type:  defect (bug)      |     Status:  new
 Priority:  normal            |  Milestone:  Awaiting Review
Component:  Build/Test Tools  |    Version:
 Severity:  normal            |   Keywords:
  Focuses:                    |
------------------------------+-----------------------------
 The WordPress Core development environment does not include proper Xdebug
 configuration for debugging from host IDEs like VS Code. While Xdebug is
 enabled in the PHP container, the `client_host` setting defaults to
 `localhost`, which prevents debugging connections from working when the
 IDE is running on the host machine.

 Steps to Reproduce:

 1. Clone the wordpress-develop repository
 2. Set `LOCAL_PHP_XDEBUG=true` in `.env` to enable Xdebug
 3. Run the WordPress instance with instructions given in README.
 4. Configure VS Code to listen for Xdebug connections.
 5. Set breakpoints in PHP files
 6. Visit the WordPress site with Xdebug session enabled

 Result:
 Breakpoints are not triggered.

 Expected:
 Breakpoints should be triggered.

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/63979>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform


More information about the wp-trac mailing list