write the breakpoints guide page

[carlos-granados]

Replaces the breakpoints placeholder with the full guide page, IDE-agnostic throughout.

Covers line, function (call and return), exception, temporary and conditional breakpoints, hit counts and hit conditions, enabling and disabling, and php_debugger_break(). Ends with the caveat about removing breakpoints once you are done with them.

Behaviour verified against handler_dbgp.c and debugger.c rather than upstream docs. Points worth noting:

• exception matching walks the parent chain, so a parent class catches everything below it, and * catches all
• PHP error levels (Warning, Notice, Deprecated, Fatal error) are matched as pseudo-exceptions
• the hit counter only advances on hits where the condition was true, so a condition plus == 3 stops on the third time the condition held, not the third time the line ran
• temporary breakpoints disable themselves rather than deleting themselves

Note: php_debugger_break() does not exist yet — only xdebug_break() is defined today.

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-09-04 16:35 UTC