write the phpstorm integration page

[carlos-granados]

Writes the PhpStorm integration page. It follows the User Guide section by section — one section each for starting the debugger, connecting, breakpoints, step debugging, inspecting variables, watches and edits, logging and troubleshooting — with a short summary of what each looks like in PhpStorm and a link on to JetBrains' own documentation.

Every external URL was checked for status and page title before use. Three candidates that 404 (watches.html, adding-watches.html, setting-variable-values.html) were dropped in favour of the pages that actually cover those topics.

Points where PhpStorm's behaviour meets ours, rather than restating either side:

• the only switch is Start Listening, since nothing needs starting on our side; Break at first line in PHP scripts is flagged because every request now arrives
• Mute Breakpoints hides breakpoints from you but not from the debugger, so the overhead stays until they are removed
• PHP_IDE_CONFIG=serverName=... is needed for CLI runs only — over HTTP PhpStorm matches the server entry by the requested URL — and getting it wrong looks exactly like a path mapping failure
• what Force Step Into actually overrides: Debugger | Stepping (library and listed scripts) and PHP | Debug | Step Filters (magic methods, constructors, named methods), which are two separate settings pages

No keyboard shortcuts anywhere, since they vary by keymap.

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-09-13 18:37 UTC