A lightweight, high-performance PHP debugger extension. Forked from Xdebug by Derick Rethans, stripped down to pure debugging, and optimized for near-zero overhead when inactive.
Note
🧪 This project is an experiment to show how fast the PHP community can move using AI tools.
The entire extension — fork, strip, optimize, rename — was built in days, not months, using PhpStorm, Claude Code, OpenClaw. We're here to move fast, adapt to change, and prove that PHP tooling can be the best in the industry.
- +4% overhead when loaded but inactive (vs +324% in Xdebug)
- Drop-in Xdebug replacement — existing configs, IDE setups, and workflows work unchanged
- Debug-only — no profiler, no coverage, no tracing. Just debugging.
- Full DBGp protocol support — works with PhpStorm, VS Code, and any DBGp-compatible IDE
bench.php on Apple Silicon, PHP 8.5.3. Extension loaded, xdebug.mode=debug, no IDE connected.
| Configuration | Time | Overhead |
|---|---|---|
| No debugger | 0.139s | — |
| PHP Debugger | 0.145s | +4% |
| Xdebug | 0.589s | +324% |
Grab the right binary from Releases, copy it to your extension directory, and add to php.ini:
zend_extension=php_debugger.soQuick install script:
curl -fsSL https://raw.githubusercontent.com/pronskiy/php-debugger/main/install.php | phpPIE (PHP Installer for Extensions):
pie install pronskiy/php-debugger
PHP Debugger accepts both php_debugger.* and xdebug.* INI prefixes. Existing Xdebug configurations work as-is.
; Both of these work: php_debugger.mode = debug php_debugger.client_host = 127.0.0.1 php_debugger.client_port = 9003 php_debugger.start_with_request = trigger ; Xdebug-compatible (also works): xdebug.mode = debug xdebug.client_host = 127.0.0.1 xdebug.client_port = 9003 xdebug.start_with_request = trigger
Works as-is. Just swap the extension and your existing debug configurations work.
Configuring Debugger in PhpStorm
Works as-is. No changes needed.
PHP Debugger is a drop-in replacement for Xdebug's debug mode:
| Feature | PHP Debugger | Xdebug |
|---|---|---|
extension_loaded("xdebug") |
✅ true | ✅ true |
extension_loaded("php_debugger") |
✅ true | ❌ false |
xdebug.* INI settings |
✅ works | ✅ works |
xdebug_break() |
✅ works | ✅ works |
XDEBUG_SESSION trigger |
✅ works | ✅ works |
| Step debugging (DBGp) | ✅ | ✅ |
| Code coverage | ❌ use pcov | ✅ |
| Profiling | ❌ removed | ✅ |
| Tracing | ❌ removed | ✅ |
You can also use the new names — they work alongside the Xdebug ones:
- INI:
php_debugger.mode,php_debugger.client_host, etc. - Functions:
php_debugger_break(),php_debugger_info(),php_debugger_connect_to_client(),php_debugger_is_debugger_active(),php_debugger_notify() - Triggers:
PHP_DEBUGGER_SESSION,PHP_DEBUGGER_SESSION_START,PHP_DEBUGGER_TRIGGER
- PHP 8.2, 8.3, 8.4, or 8.5
Released under The Xdebug License, version 1.03 (based on The PHP License).
This product includes Xdebug software, freely available from https://xdebug.org/.
PHP Debugger is built on the foundation of Xdebug, created and maintained by Derick Rethans since 2002. His two decades of work on PHP debugging tools made this project possible. Thank you, Derick.