PHPDBG是一个PHP的SAPI模块,可以在不用修改代码和不影响性能的情况下控制PHP的运行环境。
PHPDBG的目标是成为一个轻量级、强大、易用的PHP调试平台。可以在PHP5.4和之上版本中使用。在PHP5.6和之上版本将内部集成。
主要功能:
– 单步调试
– 灵活的下断点方式(类方法、函数、文件:行、内存地址、opcode)
– 可以查看当前执行的代码
– 用户空间API(userland/user space)
– 方便集成
– JIT全局变量
– readline支持(可选),终端操作更方便
– 远程debug,使用java GUI
– 操作简便(具体看help)
安装
为了使用PHPdgb,你首先需要下载一个PHP的源码包。然后下载PHPdgb的源码包,并放在PHP源码包的sapi目录下。最后,你就可以执行命令安装了。编译安装示例如下:假设我们已经下载PHP的源码包,并放在了/home/PHP目录下。
注意:
1、如果你的PHP版本是PHP5.6或者更高的版本,PHPdbg已经集成在PHP的代码包中,无需单独下载了。
2、编译参数中记得要加 –enable-PHPdbg。
3、编译时参数,–with-readline 可以选择性添加。如果不添加,PHPdbg的history等功能无法使用。
基本使用
1、参数介绍 PHPdbg是PHP的一个sapi,它可以以命令行的方式调试PHP。常用参数如下:The following switches are implemented (just like cli SAPI):
-n ignore PHP ini
-c search for PHP ini in path
-z load zend extension
-d define PHP ini entry
The following switches change the default behavIoUr of PHPdbg:
-v disables quietness
-s enabled stepping
-e sets execution context
-b boring – disables use of colour on the console
-I ignore .PHPdbginit (default init file)
-i override .PHPgdbinit location (implies -I)
-O set oplog output file
-q do not print banner on startup
-r jump straight to run
-E enable step through eval()
Note: passing -rr will cause PHPdbg to quit after execution,rather than returning to the console
2、常用功能 之前我们介绍过gdb工具。其实PHPdbg和gdb功能有些地方非常相似。如,可以设置断点,可以单步执行,等。只是他们调试的语言不一样,gdb侧重于调试c或者c++语言,而PHPdbg侧重于调试PHP语言。下面我们将对PHPdbg的一些常用调试功能做下介绍。要调试的代码如下:
$param = "ali";
$param = $param + "baba";
echo "function func $param\n";
}
$demo = new demo();
$demo->func(1);
func();
PHPdbg_inc_func();
?>
3、启动PHPdbg
PHPdbg安装成功后,会在安装目录的bin目录下。进入bin目录,直接输入PHPdbg即可。如下:
要想加载要调试的PHP脚本,只需要执行exec命令即可。如下:
当然我们也可以在启动PHPdbg的时候,指定e参数。如下:
4、查看帮助信息
如果你之前使用过其他的调试工具,你会发现PHPdbg和他们比较相似。但是,你使用初期,还是会经常需要获取帮助信息。通过help命令我们可以获取帮助信息。
PHPdbg is a lightweight,powerful and easy to use debugging platform for PHP5.4+
It supports the following commands:
Information
list list PHP source
......
5、设置断点
设置断点的命令和gdb一样。都是break,简写形式为b。不过具体的命令参数还是有所差异的。和gdb的断点命令相同之处,它们都可以“按文件名:行号” 或者 行号的方式设置断点。除此之外,PHPdbg还提供了一些针对PHP特有的设置断点的方式。如,根据opline设置断点,根据opcode设置断点等。
众所周知,PHP代码最终是解析成opcode,然后由PHP内核一条条执行。一条PHP语句,可能会解析成多条opcode。如果可以按opcode设置断点,我们就可以更精确的跟踪程序执行过程。下面我们来看看phapdbg设置断点的具体示例。
按opline设置断点:
这里所说的opline,就是以方法入口作为起点,当前代码的行号。如test_PHPdgb.PHP文件中,第18行的代码“$param = $param + “baba”;”的opline就是 2。
6、查看断点
和gdb一样,PHPdbg也是使用info break命令查看断点。示例如下:
通过上面的显示,我们可以知道。info break的显示结果中会把断点的类型也给显示出来。#后面的数字是断点号。我们可以根据断点号删除断点。
7、删除断点
和gdb命令不一样。PHPdbg的删除断点不是delete命令,而是break del 命令。示例如下:
break del 后面的数字1就是断点号。
8、查看代码
PHPdbg查看代码的命令也是list。但是和gdb相比,使用的方式更多样一些。
单步执行
PHPdbg的单步执行只有一个命令 step。和gdb的step命令差不多。都是一行一行的执行代码。注意,PHPdbg是没有next命令的。
继续执行
和gdb一样,PHPdbg的继续执行命令也是continue,简写形式为c。
这个是PHPdbg的一个特色。可以在调试的过程中使用ev命令执行任意的PHP代码。如: