[ php-wasm ] Xdebug and IDEs #2435

Xdebug is currently supported in PHP.wasm versions from 7.2 to 8.4. It has been introduced in the Node version of PHP.wasm. [ Asyncify and JSPI ]. Practically : any script using the loadNodeRuntime can enable Xdebug.

Progress

• Documentation - Overview of Xdebug in PHP.wasm
• Code examples - How to enable Xdebug in PHP.wasm
• Code examples - Overview of Xdebug in PHP.wasm in IDEs
• Documentation - Xdebug with PHP.wasm Node in IDEs
• Code examples - Xdebug with PHP.wasm Node in IDEs
• Documentation - Xdebug with PHP.wasm CLI in IDEs
• Code examples - Xdebug with PHP.wasm CLI in IDEs
• Documentation - Xdebug with WP Playground CLI in IDEs
• Code examples - Xdebug with WP Playground CLI in IDE

Under development

• WP Playground CLI - VSCode
• WP Playground CLI - PHPStorm
• PHP.wasm Node - VSCode
• PHP.wasm Node - PHPStorm
• PHP.wasm CLI - VSCode
• PHP.wasm CLI - PHPStorm

What are the current limitations

• Xdebug is not available on PHP.wasm Web.

• The virtual filesystem is currently not available for step debugging. This issue is listing the possible solutions to give access to it. And this pull request is fixing the issue.

• When starting the debugging phase using @php-wasm/cli, Xdebug pauses at the first PHP line.

Related links

• [XDebug] Path mapping in PHP Storm #2763
• [ php-wasm ] Follow-up on Xdebug #2315

cc @fellyph @adamziel