簡介
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，轉載請註明來源！