PHPDBG是一個PHP的SAPI模塊,可以在不用修改代碼和不影響性能的情況下控制PHP的運行環(huán)境。
PHPDBG的目標(biāo)是成為一個輕量級、強大、易用的PHP調(diào)試平臺??梢栽赑HP5.4和之上版本中使用。在php5.6和之上版本將內(nèi)部集成。
主要功能:
– 單步調(diào)試
– 靈活的下斷點方式(類方法、函數(shù)、文件:行、內(nèi)存地址、opcode)
– 可直接調(diào)用php的eval
– 可以查看當(dāng)前執(zhí)行的代碼
– 用戶空間API(userland/user space)
– 方便集成
– 支持指定php配置文件
– JIT全局變量
– readline支持(可選),終端操作更方便
– 遠(yuǎn)程debug,使用java GUI
– 操作簡便(具體看help)
安裝
為了使用phpdgb,你首先需要下載一個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的代碼包中,無需單獨下載了。
2、編譯參數(shù)中記得要加 –enable-phpdbg。
3、編譯時參數(shù),–with-readline 可以選擇性添加。如果不添加,phpdbg的history等功能無法使用。
基本使用
1、參數(shù)介紹
phpdbg是php的一個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、常用功能
之前我們介紹過gdb工具。其實phpdbg和gdb功能有些地方非常相似。如,可以設(shè)置斷點,可以單步執(zhí)行,等。只是他們調(diào)試的語言不一樣,gdb側(cè)重于調(diào)試c或者c++語言,而phpdbg側(cè)重于調(diào)試php語言。下面我們將對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、啟動phpdbg
phpdbg安裝成功后,會在安裝目錄的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)然我們也可以在啟動phpdbg的時候,指定e參數(shù)。如下:
#phpdbg -e ./test_phpdbg.php
4、查看幫助信息
如果你之前使用過其他的調(diào)試工具,你會發(fā)現(xiàn)phpdbg和他們比較相似。但是,你使用初期,還是會經(jīng)常需要獲取幫助信息。通過help命令我們可以獲取幫助信息。
......prompt> helpphpdbg 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è)置斷點
設(shè)置斷點的命令和gdb一樣。都是break,簡寫形式為b。不過具體的命令參數(shù)還是有所差異的。和gdb的斷點命令相同之處,它們都可以“按文件名:行號” 或者 行號的方式設(shè)置斷點。除此之外,phpdbg還提供了一些針對php特有的設(shè)置斷點的方式。如,根據(jù)opline設(shè)置斷點,根據(jù)opcode設(shè)置斷點等。
眾所周知,php代碼最終是解析成opcode,然后由php內(nèi)核一條條執(zhí)行。一條php語句,可能會解析成多條opcode。如果可以按opcode設(shè)置斷點,我們就可以更精確的跟蹤程序執(zhí)行過程。下面我們來看看phapdbg設(shè)置斷點的具體示例。
按opline設(shè)置斷點:
這里所說的opline,就是以方法入口作為起點,當(dāng)前代碼的行號。如test_phpdgb.php文件中,第18行的代碼“$param = $param + “baba”;”的opline就是 2。
......prompt> b func#2prompt> rdemo::__construct:5method 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、查看斷點
和gdb一樣,phpdbg也是使用info break命令查看斷點。示例如下:
....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的顯示結(jié)果中會把斷點的類型也給顯示出來。#后面的數(shù)字是斷點號。我們可以根據(jù)斷點號刪除斷點。
7、刪除斷點
和gdb命令不一樣。phpdbg的刪除斷點不是delete命令,而是break del 命令。示例如下:
......prompt> break del 1[Deleted breakpoint #1]prompt>......
break del 后面的數(shù)字1就是斷點號。
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í)行只有一個命令 step。和gdb的step命令差不多。都是一行一行的執(zhí)行代碼。注意,phpdbg是沒有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,簡寫形式為c。
執(zhí)行php代碼
這個是phpdbg的一個特色。可以在調(diào)試的過程中使用ev命令執(zhí)行任意的php代碼。如:
......prompt> ev $var = "val";valprompt> ev var_dump($var);string(3) "val"......
可以通過這種方式,在調(diào)試過程中動態(tài)的修改變量值,查看執(zhí)行效果。
以上就是本文的全部內(nèi)容,輕松玩轉(zhuǎn)調(diào)試?yán)鱌HPDBG,希望大家喜歡。

















