phpdbg 是 PHP 官方内置的轻量级 CLI 调试器，从 PHP 5.6 起默认集成，启动快、开销小，仅支持行/文件断点和命令行交互调试；而 Xdebug 需手动安装，支持远程调试、IDE 图形断点、条件断点及性能分析，但性能开销大。
phpdbg 是什么，和 Xdebug 有什么区别
phpdbg 是 PHP 官方内置的轻量级 CLI 调试器，从 PHP 5.6 开始默认编译进解释器（只要没被 configure 时禁用）。它不依赖外部扩展，不挂钩 Zend 引擎的执行钩子，因此启动快、内存开销小，适合调试 CLI 脚本或简单 Web 入口（如 index.php 直接运行）。
和 Xdebug 最大区别在于：phpdbg 不提供远程调试协议（如 DBGp），也不支持 IDE 图形断点联动；它本质是交互式命令行调试器，类似 GDB 之于 C。如果你需要在 PhpStorm 或 VS Code 里点鼠标设断点，phpdbg 做不到——得用 Xdebug 或 Zend Debugger。
- Xdebug 需额外安装扩展，启用后会影响脚本整体性能（尤其开启 Profiling 或 Coverage）
-
phpdbg启动即用：phpdbg -qrr script.php，无配置成本 -
phpdbg不支持条件断点、函数断点（break function_name会报错），只支持行号断点和文件断点
怎么启动 phpdbg 并设置第一个断点
最简启动方式就是加 -qrr 参数：静默模式（-q）、自动运行（-r）、运行指定脚本（-r 后跟文件路径）。
phpdbg -qrr /path/to/test.php
进入交互模式后，用 break 命令设断点。注意：必须先用 list 查看当前文件上下文，否则容易输错行号。
立即学习“PHP免费学习笔记（深入）”；
-
list 10：显示第 10 行附近代码（默认显示 10 行） -
break 15：在当前文件第 15 行设断点 -
break /full/path/to/file.php:22：跨文件设断点（路径必须绝对或相对于当前工作目录） -
run：开始执行，遇到断点暂停 -
step或next：单步进入 / 单步跳过函数调用
常见错误：直接输 break test.php:5 报错。原因：phpdbg 不解析相对路径，必须用绝对路径或先用 file test.php 加载文件再设行断点。
怎么查看变量值和执行上下文
断点停住后，print 和 dump 是两个核心命令：
-
print $var_name：输出变量名对应的值（仅限当前作用域） -
dump $var_name：递归展开变量结构（对数组、对象更友好） -
backtrace：查看调用栈，等价于bt -
eval var_dump($_GET)：执行任意 PHP 表达式（注意引号和转义）
注意作用域限制：print 只能访问当前栈帧的局部变量；如果想看全局变量（如 $_SERVER），得用 eval 显式调用。另外，dump 对资源类型（如 mysqli 连接）可能只显示 Resource id #n，无法展开。
一个易忽略点：phpdbg 默认不加载 auto_prepend_file 或 auto_append_file，所以如果你的调试脚本依赖这些配置，要手动用 exec 加载或改用完整 CLI 环境（比如 php -d auto_prepend_file=init.php $(which phpdbg) -qrr script.php）。
phpdbg 在 Web 环境下能用吗
不能直接用于 Apache/Nginx 的常规请求流程。phpdbg 是 CLI SAPI 的调试器，它不监听端口、不嵌入到 FPM 或 mod_php 中。但有折中方案：
- 把 Web 入口（如
index.php）当成 CLI 脚本运行：phpdbg -qrr public/index.php，并手动模拟$_GET、$_SERVER等超全局变量（用eval注入） - 在脚本开头加
if (!isset($_SERVER['argv'])) { die('Run via phpdbg'); }防误访问 - 用
phpdbg -s启动内置服务器（PHP 7.4+），但仅限静态文件和简单路由，不兼容现代框架的 autoload 或中间件机制
真正想调试 Web 请求流，还是得切回 Xdebug + IDE。phpdbg 的价值在于快速验证 CLI 工具、Composer 脚本、单元测试失败点——尤其是当你发现 Xdebug 导致 phpunit 执行慢出天际时，换 phpdbg 往往能秒出结果。
