PHPDBG是一個(gè)PHP的SAPI模塊，可以在不用修改代碼和不影響性能的情況下控制PHP的運(yùn)行環(huán)境。

PHPDBG的目標(biāo)是成為一個(gè)輕量級(jí)、強(qiáng)大、易用的PHP調(diào)試平臺(tái)。可以在PHP5.4和之上版本中使用。在php5.6和之上版本將內(nèi)部集成。

主要功能：

– 單步調(diào)試

– 靈活的下斷點(diǎn)方式（類方法、函數(shù)、文件:行、內(nèi)存地址、opcode）

– 可直接調(diào)用php的eval

– 可以查看當(dāng)前執(zhí)行的代碼

– 用戶空間API（userland/user space）

– 方便集成

– 支持指定php配置文件

– JIT全局變量

– readline支持（可選），終端操作更方便

– 遠(yuǎn)程debug，使用java GUI

– 操作簡(jiǎn)便（具體看help）

安裝
為了使用phpdgb，你首先需要下載一個(gè)php的源碼包。然后下載phpdgb的源碼包，并放在php源碼包的sapi目錄下。最后，你就可以執(zhí)行命令安裝了。編譯安裝示例如下：

假設(shè)我們已經(jīng)下載php的源碼包，并放在了/home/php目錄下。

#cd /home/php/sapi
#git clone https://github.com/krakjoe/phpdbg
#cd ../
#./buildconf --force
#./config.nice
#make -j8
#make install-phpdbg

注意：

1、如果你的php版本是php5.6或者更高的版本，phpdbg已經(jīng)集成在php的代碼包中，無(wú)需單獨(dú)下載了。

2、編譯參數(shù)中記得要加 –enable-phpdbg。

3、編譯時(shí)參數(shù)，–with-readline 可以選擇性添加。如果不添加，phpdbg的history等功能無(wú)法使用。

基本使用
1、參數(shù)介紹
phpdbg是php的一個(gè)sapi，它可以以命令行的方式調(diào)試php。常用參數(shù)如下：

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、常用功能
之前我們介紹過(guò)gdb工具。其實(shí)phpdbg和gdb功能有些地方非常相似。如，可以設(shè)置斷點(diǎn)，可以單步執(zhí)行，等。只是他們調(diào)試的語(yǔ)言不一樣，gdb側(cè)重于調(diào)試c或者c++語(yǔ)言，而phpdbg側(cè)重于調(diào)試php語(yǔ)言。下面我們將對(duì)phpdbg的一些常用調(diào)試功能做下介紹。要調(diào)試的代碼如下：

文件test_phpdbg_inc.php源代碼如下：

<?php 
function phpdbg_inc_func()
{   
  echo "phpdbg_inc_func \n"; 
} 
?>

文件test_phpdgb.php的源代碼如下：

<?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();
?>

3、啟動(dòng)phpdbg

phpdbg安裝成功后，會(huì)在安裝目錄的bin目錄下。進(jìn)入bin目錄，直接輸入phpdbg即可。如下：

#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>

要想加載要調(diào)試的php腳本，只需要執(zhí)行exec命令即可。如下：

#phpdbg
......
prompt> exec ./test_phpdbg.php

當(dāng)然我們也可以在啟動(dòng)phpdbg的時(shí)候，指定e參數(shù)。如下：

#phpdbg -e ./test_phpdbg.php

4、查看幫助信息

如果你之前使用過(guò)其他的調(diào)試工具，你會(huì)發(fā)現(xiàn)phpdbg和他們比較相似。但是，你使用初期，還是會(huì)經(jīng)常需要獲取幫助信息。通過(guò)help命令我們可以獲取幫助信息。

......
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
......

5、設(shè)置斷點(diǎn)

設(shè)置斷點(diǎn)的命令和gdb一樣。都是break，簡(jiǎn)寫形式為b。不過(guò)具體的命令參數(shù)還是有所差異的。和gdb的斷點(diǎn)命令相同之處，它們都可以“按文件名:行號(hào)” 或者 行號(hào)的方式設(shè)置斷點(diǎn)。除此之外，phpdbg還提供了一些針對(duì)php特有的設(shè)置斷點(diǎn)的方式。如，根據(jù)opline設(shè)置斷點(diǎn)，根據(jù)opcode設(shè)置斷點(diǎn)等。

眾所周知，php代碼最終是解析成opcode，然后由php內(nèi)核一條條執(zhí)行。一條php語(yǔ)句，可能會(huì)解析成多條opcode。如果可以按opcode設(shè)置斷點(diǎn)，我們就可以更精確的跟蹤程序執(zhí)行過(guò)程。下面我們來(lái)看看phapdbg設(shè)置斷點(diǎn)的具體示例。

按opline設(shè)置斷點(diǎn)：

這里所說(shuō)的opline，就是以方法入口作為起點(diǎn)，當(dāng)前代碼的行號(hào)。如test_phpdgb.php文件中，第18行的代碼“$param = $param + “baba”;”的opline就是 2。

......
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: }
......

6、查看斷點(diǎn)

和gdb一樣，phpdbg也是使用info break命令查看斷點(diǎn)。示例如下：

....
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
....

通過(guò)上面的顯示，我們可以知道。info break的顯示結(jié)果中會(huì)把斷點(diǎn)的類型也給顯示出來(lái)。#后面的數(shù)字是斷點(diǎn)號(hào)。我們可以根據(jù)斷點(diǎn)號(hào)刪除斷點(diǎn)。

7、刪除斷點(diǎn)

和gdb命令不一樣。phpdbg的刪除斷點(diǎn)不是delete命令，而是break del 命令。示例如下：

......
prompt> break del 1
[Deleted breakpoint #1]
prompt>
......

break del 后面的數(shù)字1就是斷點(diǎn)號(hào)。

8、查看代碼

phpdbg查看代碼的命令也是list。但是和gdb相比，使用的方式更多樣一些。

顯示指定函數(shù)的代碼：

......
prompt> l f func
 00017:   $param = "ali";
 00018:   $param = $param + "baba";
 00019:   echo "function func $param\n";;
 00020: }
 00021:
prompt>
......

單步執(zhí)行

phpdbg的單步執(zhí)行只有一個(gè)命令 step。和gdb的step命令差不多。都是一行一行的執(zhí)行代碼。注意，phpdbg是沒(méi)有next命令的。

....
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:
....

繼續(xù)執(zhí)行

和gdb一樣，phpdbg的繼續(xù)執(zhí)行命令也是continue，簡(jiǎn)寫形式為c。

執(zhí)行php代碼

這個(gè)是phpdbg的一個(gè)特色?？梢栽谡{(diào)試的過(guò)程中使用ev命令執(zhí)行任意的php代碼。如：

......
prompt> ev $var = "val";
val
prompt> ev var_dump($var);
string(3) "val"
......

可以通過(guò)這種方式，在調(diào)試過(guò)程中動(dòng)態(tài)的修改變量值，查看執(zhí)行效果。

以上就是本文的全部?jī)?nèi)容，輕松玩轉(zhuǎn)調(diào)試?yán)鱌HPDBG，希望大家喜歡。