用 OpenClaw 写了个轻量级、高性能 PHP 调试器扩展

PHP Debugger

一个轻量级、高性能的 PHP 调试器扩展。从 Xdebug（作者 Derick Rethans）fork 而来，去除了除调试外的所有功能，并针对几乎零开销（未激活时）进行了深度优化。

“注意：这个项目是一个实验，旨在展示 PHP 社区使用 AI 工具能有多快。 整个扩展——分支、精简、优化、重命名——都是使用 PhpStorm、Claude Code、OpenClaw 在几天内而不是几个月内完成的。我们在这里是为了快速行动、适应变化，并证明 PHP 工具可以成为行业中的最佳。

为什么选择 PHP Debugger？

• 加载但未激活时仅 +4% 开销（对比 Xdebug 的 +324%）
• 可直接替换 Xdebug —— 现有配置、IDE 设置、工作流完全无需改动
• 只保留调试功能 —— 没有性能分析器、没有代码覆盖率、没有追踪功能，只有调试
• 完整支持 DBGp 协议 —— 与 PhpStorm、VS Code 以及任何支持 DBGp 的 IDE 兼容

性能对比

在 Apple Silicon + PHP 8.5.3 上运行 bench.php，扩展已加载，xdebug.mode=debug，无 IDE 连接状态：

安装方式

手动下载安装

从 Releases 页面下载对应平台的二进制文件，放到你的 PHP 扩展目录，然后在 php.ini 中添加：

zend_extension=php_debugger.so

即将支持的快捷安装方式（建设中）

一键安装脚本：

curl -fsSL https://raw.githubusercontent.com/pronskiy/php-debugger/main/install.php | php

使用 PIE（PHP Installer for Extensions）：

pie install pronskiy/php-debugger

配置说明

PHP Debugger 同时支持 php_debugger.* 和 xdebug.* 两种前缀的配置项。 你现有的 Xdebug 配置可以直接继续使用，无需任何修改。

; 两种写法都有效：
php_debugger.mode = debug
php_debugger.client_host = 127.0.0.1
php_debugger.client_port = 9003
php_debugger.start_with_request = trigger

; Xdebug 兼容写法（也完全有效）：
xdebug.mode = debug
xdebug.client_host = 127.0.0.1
xdebug.client_port = 9003
xdebug.start_with_request = trigger

IDE 配置

PhpStorm

直接替换扩展后，原有调试配置无需任何改动即可使用。参考官方文档：https://www.jetbrains.com/help/phpstorm/configuring-xdebug.html

VS Code

同样直接兼容，无需任何更改。

与 Xdebug 的兼容性对比

PHP Debugger 是 Xdebug 调试模式的直接替代品：

可选的新命名（与旧命名并存）

你也可以选择使用新的命名方式，它们与 Xdebug 的旧名称完全兼容并存：

• INI 配置：php_debugger.mode、php_debugger.client_host 等
• 函数：php_debugger_break()、php_debugger_info()、php_debugger_connect_to_client()、php_debugger_is_debugger_active()、php_debugger_notify()
• 触发器：PHP_DEBUGGER_SESSION、PHP_DEBUGGER_SESSION_START、PHP_DEBUGGER_TRIGGER

系统要求

• PHP 8.2、8.3、8.4 或 8.5