简介
PHPDBG是一个PHP的SAPI模块，能够在不用修改代码和不影响性能的状况下控制PHP的运行环境。php
PHPDBG的目标是成为一个轻量级、强大、易用的PHP调试平台。能够在PHP5.4和之上版本中使用。在php5.6和之上版本将内部集成。java
主要功能：
- 单步调试c++
- 灵活的下断点方式（类方法、函数、文件:行、内存地址、opcode）git
- 可直接调用php的evalgithub
- 能够查看当前执行的代码c#
- 用户空间API（userland/user space）api
- 方便集成bash
- 支持指定php配置文件php7
- JIT全局变量app
- readline支持（可选），终端操做更方便
- 远程debug，使用java GUI
- 操做简便（具体看help）
安装
为了使用phpdgb，你首先须要下载一个php的源码包。而后下载phpdgb的源码包，并放在php源码包的sapi目录下。最后，你就能够执行命令安装了。编译安装示例以下：
假设咱们已经下载php的源码包，并放在了/home/php目录下。
|
1
2
3
4
5
6
7
|
#cd /home/php/sapi
#git clone https://github.com/krakjoe/phpdbg
#cd ../
#./buildconf --force
#./config.nice
#make -j8
#make install-phpdbg
|
注意：
一、若是你的php版本是php5.6或者更高的版本，phpdbg已经集成在php的代码包中，无需单独下载了。
二、编译参数中记得要加 --enable-phpdbg。
三、编译时参数，--with-readline 能够选择性添加。若是不添加，phpdbg的history等功能没法使用。
基本使用
参数介绍
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
经常使用功能
以前咱们介绍过gdb工具。其实phpdbg和gdb功能有些地方很是类似。如，能够设置断点，能够单步执行，等。只是他们调试的语言不同，gdb侧重于调试c或者c++语言，而phpdbg侧重于调试php语言。下面咱们将对phpdbg的一些经常使用调试功能作下介绍。
要调试的代码以下：
文件test_phpdbg_inc.php源代码以下：
|
1
2
3
4
5
6
|
<?php
function
phpdbg_inc_func()
{
echo
"phpdbg_inc_func \n"
;
}
?>
|
文件test_phpdgb.php的源代码以下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
<?php
include
(dirname(
__FILE__
).
"/test_phpdbg_inc.php"
);
class
demo{
public
function
__construct(){
echo
__METHOD__
.
":"
.
__LINE__
.
"\n"
;
}
public
function
func(
$param
){
$param
++;
echo
"method func $param\n"
;
}
public
function
__destruct(){
echo
__METHOD__
.
":"
.
__LINE__
.
"\n"
;
}
}
function
func(){
$param
=
"ali"
;
$param
=
$param
+
"baba"
;
echo
"function func $param\n"
;
}
$demo
=
new
demo();
$demo
->func(1);
func();
phpdbg_inc_func();
?>
|
启动phpdbg
phpdbg安装成功后，会在安装目录的bin目录下。进入bin目录，直接输入phpdbg便可。以下：
|
1
2
3
4
5
|
#phpdeg
[Welcome to phpdbg, the interactive PHP debugger, v0.4.0]
To get help using phpdbg
type
"help"
and press enter
[Please report bugs to <http:
//github
.com
/krakjoe/phpdbg/issues
>]
prompt>
|
要想加载要调试的php脚本，只须要执行exec命令便可。以下：
|
1
2
3
|
#phpdbg
......
prompt>
exec
.
/test_phpdbg
.php
|
固然咱们也能够在启动phpdbg的时候，指定e参数。以下：
|
1
|
#phpdbg -e ./test_phpdbg.php
|
查看帮助信息
若是你以前使用过其余的调试工具，你会发现phpdbg和他们比较类似。可是，你使用初期，仍是会常常须要获取帮助信息。经过help命令咱们能够获取帮助信息。
|
1
2
3
4
5
6
7
8
9
|
......
prompt> 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
......
|
设置断点
设置断点的命令和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。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
......
prompt> b func
#2
prompt> r
demo::__construct:5
method func 2
[Breakpoint
#0 resolved at func#2 (opline 0x7f5b230a2e38)]
[Breakpoint
#0 resolved at func#2 (opline 0x7f5b230a2e38)]
[Breakpoint
#0 resolved at func#2 (opline 0x7f5b230a2e38)]
[Breakpoint
#0 in func()#2 at ./test_phpdbg.php:18, hits: 1]
>00018: $param = $param +
"baba"
;
00019:
echo
"function func $param\n"
;;
00020: }
......
|
查看断点
和gdb同样，phpdbg也是使用info break命令查看断点。示例以下：
|
1
2
3
4
5
6
7
8
9
10
11
12
|
....
prompt> info
break
------------------------------------------------
File Breakpoints:
#1 /home/hailong.xhl/test_phpdbg.php:10
------------------------------------------------
Opline Breakpoints:
#0 7ff3219e1df0 (function breakpoint)
------------------------------------------------
Function opline Breakpoints:
#0 func opline 2
....
|
经过上面的显示，咱们能够知道。info break的显示结果中会把断点的类型也给显示出来。#后面的数字是断点号。咱们能够根据断点号删除断点。
删除断点
和gdb命令不同。phpdbg的删除断点不是delete命令，而是break del 命令。示例以下：
|
1
2
3
4
5
|
......
prompt>
break
del 1
[Deleted breakpoint
#1]
prompt>
......
|
break del 后面的数字1就是断点号。
查看代码
phpdbg查看代码的命令也是list。可是和gdb相比，使用的方式更多样一些。
显示指定函数的代码：
|
1
2
3
4
5
6
7
8
9
|
......
prompt> l f func
00017: $param =
"ali"
;
00018: $param = $param +
"baba"
;
00019:
echo
"function func $param\n"
;;
00020: }
00021:
prompt>
......
|
单步执行
phpdbg的单步执行只有一个命令 step。和gdb的step命令差很少。都是一行一行的执行代码。注意，phpdbg是没有next命令的。
|
1
2
3
4
5
6
7
8
|
....
prompt> s
[Breakpoint
#0 resolved at func#2 (opline 0x152ba40)]
[L19 0x152ba70 ZEND_ADD_STRING C2 @0 .
/test_phpdbg
.php]
>00019:
echo
"function func $param\n"
;;
00020: }
00021:
....
|
继续执行
和gdb同样，phpdbg的继续执行命令也是continue，简写形式为c。
执行php代码
这个是phpdbg的一个特点。能够在调试的过程当中使用ev命令执行任意的php代码。如：
|
1
2
3
4
5
6
|
......
prompt> ev $var =
"val"
;
val
prompt> ev var_dump($var);
string(3)
"val"
......
|
能够经过这种方式，在调试过程当中动态的修改变量值，查看执行效果。
原文连接：php调试利器之phpdbg，转载请注明来源！