Name Date Size #Lines LOC

..05-Dec-2019-

tests/H05-Dec-2019-

.gdbinitH A D05-Dec-2019250 1110

.phpdbginitH A D05-Dec-20192.5 KiB10691

CREDITSH A D05-Dec-201945 32

Changelog.mdH A D05-Dec-20191.8 KiB5343

Makefile.fragH A D05-Dec-20191.5 KiB4230

README.mdH A D05-Dec-20192.4 KiB8261

config.m4H A D05-Dec-20193.2 KiB8971

config.w32H A D05-Dec-20191.3 KiB3428

create-test.phpH A D05-Dec-20194 KiB151110

phpdbg.1.inH A D05-Dec-20192.8 KiB151150

phpdbg.cH A D19-May-202061.4 KiB2,2171,732

phpdbg.hH A D05-Dec-201913 KiB337257

phpdbg.init.dH A D05-Dec-20192.8 KiB123115

phpdbg_bp.cH A D05-Dec-201957.6 KiB1,6771,322

phpdbg_bp.hH A D05-Dec-20196.1 KiB16494

phpdbg_break.cH A D05-Dec-20192.1 KiB5625

phpdbg_break.hH A D05-Dec-20191.6 KiB389

phpdbg_btree.cH A D05-Dec-20197.4 KiB263194

phpdbg_btree.hH A D05-Dec-20193 KiB7340

phpdbg_cmd.cH A D05-Dec-201920.4 KiB838651

phpdbg_cmd.hH A D05-Dec-20196.1 KiB188116

phpdbg_eol.cH A D05-Dec-20194.2 KiB173122

phpdbg_eol.hH A D05-Dec-20191.5 KiB4618

phpdbg_frame.cH A D05-Dec-201910.1 KiB346262

phpdbg_frame.hH A D05-Dec-20191.6 KiB339

phpdbg_help.cH A D05-Dec-201939.1 KiB1,036760

phpdbg_help.hH A D05-Dec-20192 KiB5119

phpdbg_info.cH A D05-Dec-201916.9 KiB465379

phpdbg_info.hH A D05-Dec-20191.7 KiB4216

phpdbg_io.cH A D05-Dec-20197.9 KiB356267

phpdbg_io.hH A D05-Dec-20191.9 KiB4115

phpdbg_lexer.cH A D05-Dec-201945.3 KiB2,0862,051

phpdbg_lexer.hH A D05-Dec-20191.7 KiB4316

phpdbg_lexer.lH A D05-Dec-20193.8 KiB21575

phpdbg_list.cH A D05-Dec-201911.7 KiB379286

phpdbg_list.hH A D05-Dec-20192 KiB5627

phpdbg_opcode.cH A D05-Dec-20196.5 KiB195146

phpdbg_opcode.hH A D05-Dec-20192 KiB4721

phpdbg_out.cH A D05-Dec-201930.3 KiB1,3211,022

phpdbg_out.hH A D05-Dec-20195 KiB9252

phpdbg_parser.cH A D05-Dec-201955.2 KiB1,9541,323

phpdbg_parser.hH A D05-Dec-20193.5 KiB13180

phpdbg_parser.yH A D05-Dec-20194.4 KiB204172

phpdbg_print.cH A D05-Dec-201914.1 KiB422334

phpdbg_print.hH A D05-Dec-20191.7 KiB4313

phpdbg_prompt.cH A D05-Dec-201957.4 KiB1,9691,580

phpdbg_prompt.hH A D05-Dec-20192.6 KiB7242

phpdbg_rinit_hook.cH A D05-Dec-20193.5 KiB11073

phpdbg_rinit_hook.hH A D05-Dec-20191.8 KiB4215

phpdbg_set.cH A D05-Dec-20199.6 KiB289226

phpdbg_set.hH A D05-Dec-20191.7 KiB4519

phpdbg_sigio_win32.cH A D05-Dec-20192.9 KiB11266

phpdbg_sigio_win32.hH A D05-Dec-20191.4 KiB3914

phpdbg_sigsafe.cH A D05-Dec-20191.6 KiB5942

phpdbg_sigsafe.hH A D05-Dec-2019457 2516

phpdbg_utils.cH A D05-Dec-201923.2 KiB869702

phpdbg_utils.hH A D05-Dec-20195.2 KiB13685

phpdbg_wait.cH A D05-Dec-201913.2 KiB408313

phpdbg_wait.hH A D05-Dec-20191.3 KiB307

phpdbg_watch.cH A D05-Dec-201953.7 KiB1,4351,087

phpdbg_watch.hH A D05-Dec-20194.7 KiB15399

phpdbg_webdata_transfer.cH A D05-Dec-20195.2 KiB176129

phpdbg_webdata_transfer.hH A D05-Dec-20191.3 KiB286

phpdbg_win.cH A D05-Dec-20191.9 KiB4216

phpdbg_win.hH A D05-Dec-20191.6 KiB3811

test.phpH A D05-Dec-20191.1 KiB8865

web-bootstrap.phpH A D05-Dec-20192.1 KiB6547

xml.mdH A D05-Dec-201920 KiB652484

README.md

1The interactive PHP debugger
2============================
3
4Implemented as a SAPI module, phpdbg can exert complete control over the environment without impacting the functionality or performance of your code.
5
6phpdbg aims to be a lightweight, powerful, easy to use debugging platform for PHP 5.4+
7
8Features
9========
10
11 - Stepthrough Debugging
12 - Flexible Breakpoints (Class Method, Function, File:Line, Address, Opcode)
13 - Easy Access to PHP with built-in eval()
14 - Easy Access to Currently Executing Code
15 - Userland API
16 - SAPI Agnostic - Easily Integrated
17 - PHP Configuration File Support
18 - JIT Super Globals - Set Your Own!!
19 - Optional readline Support - Comfortable Terminal Operation
20 - Remote Debugging Support - Bundled Java GUI
21 - Easy Operation - See Help :)
22
23Planned
24=======
25
26 - Improve Everything :)
27
28Installation
29============
30
31To install **phpdbg**, you must compile the source against your PHP installation sources, and enable the SAPI with the configure command.
32
33```
34cd /usr/src/php-src/sapi
35git clone https://github.com/krakjoe/phpdbg
36cd ../
37./buildconf --force
38./configure --enable-phpdbg
39make -j8
40make install-phpdbg
41```
42
43Where the source directory has been used previously to build PHP, there exists a file named *config.nice* which can be used to invoke configure with the same
44parameters as were used by the last execution of *configure*.
45
46**Note:** PHP must be configured with the switch --with-readline for phpdbg to support history, autocompletion, tab-listing etc.
47
48Command Line Options
49====================
50
51The following switches are implemented (just like cli SAPI):
52
53 - -n ignore php ini
54 - -c search for php ini in path
55 - -z load zend extension
56 - -d define php ini entry
57
58The following switches change the default behaviour of phpdbg:
59
60 - -v disables quietness
61 - -s enabled stepping
62 - -e sets execution context
63 - -b boring - disables use of colour on the console
64 - -I ignore .phpdbginit (default init file)
65 - -i override .phpgdbinit location (implies -I)
66 - -O set oplog output file
67 - -q do not print banner on startup
68 - -r jump straight to run
69 - -E enable step through eval()
70 - -l listen ports for remote mode
71 - -a listen address for remote mode
72 - -S override SAPI name
73
74**Note:** Passing -rr will cause phpdbg to quit after execution, rather than returning to the console.
75
76Getting Started
77===============
78
79See the website for tutorials/documentation
80
81https://phpdbg.room11.org
82