Skip to content

Xdebug doesn't start on a normal page load, contrary to the docs #4087

Description

@juanmaguitar

Describe the bug

The Xdebug docs (https://developer.wordpress.com/docs/developer-tools/studio/xdebug/) say that once Xdebug is enabled on a site, you just need to navigate to it in the browser to trigger breakpoints. In recent versions of Studio, that's no longer true — a normal page reload doesn't start a debug session, and breakpoints never fire.

I believe this is related to the newer native PHP runtime. I'll follow up with a PR that includes the technical details and a proposed fix.

To reproduce

  1. Enable Xdebug on a site
  2. Set a breakpoint and start listening for Xdebug in your IDE
  3. Reload the site in the browser
  4. Breakpoints don't fire, contrary to what the docs describe

Expected behavior

Reloading the site should trigger the debugger, as documented.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions