Name Date Size #Lines LOC

..05-Dec-2019-

tests/H22-Apr-2021-

.gdbinitH A D05-Dec-2019250 1110

.phpdbginitH A D05-Dec-20192.5 KiB10691

CREDITSH A D05-Dec-201945 32

Makefile.fragH A D05-Dec-20191.5 KiB4230

README.mdH A D05-Dec-20192.3 KiB7959

config.m4H A D05-Dec-20193.3 KiB9781

config.w32H A D05-Dec-20191.3 KiB3428

create-test.phpH A D05-Feb-20204.4 KiB151110

phpdbg.1.inH A D02-Feb-20212.8 KiB151150

phpdbg.cH A D26-May-202061.2 KiB2,2221,737

phpdbg.hH A D05-Dec-201913 KiB337257

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

phpdbg_bp.cH A D05-Feb-202057.5 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 D26-May-202020.4 KiB838651

phpdbg_cmd.hH A D05-Dec-20196.1 KiB188116

phpdbg_eol.cH A D05-Dec-20194.2 KiB176125

phpdbg_eol.hH A D05-Dec-20191.5 KiB4618

phpdbg_frame.cH A D05-Dec-201910.1 KiB347265

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.hH A D05-Dec-20191.7 KiB4316

phpdbg_lexer.lH A D22-Apr-20213.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-201929.9 KiB1,3011,004

phpdbg_out.hH A D05-Dec-20194.9 KiB8950

phpdbg_parser.yH A D11-Jan-20214.4 KiB201170

phpdbg_print.cH A D05-Dec-201914.1 KiB422334

phpdbg_print.hH A D05-Dec-20191.7 KiB4313

phpdbg_prompt.cH A D24-Feb-202155.9 KiB1,9311,547

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 D02-Jun-202023.2 KiB864699

phpdbg_utils.hH A D05-Dec-20195.2 KiB13685

phpdbg_wait.cH A D05-Dec-201913.4 KiB414319

phpdbg_wait.hH A D05-Dec-20191.3 KiB307

phpdbg_watch.cH A D02-Jun-202054.1 KiB1,4491,098

phpdbg_watch.hH A D26-May-20204.7 KiB154100

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-Feb-20201.2 KiB8865

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

xml.mdH A D05-Dec-201920 KiB652484

README.md

1# The interactive PHP debugger
2
3Implemented as a SAPI module, phpdbg can exert complete control over the
4environment without impacting the functionality or performance of your code.
5
6phpdbg aims to be a lightweight, powerful, easy to use debugging platform for
7PHP 5.4+.
8
9## Features
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
23## Planned
24
25* Improve Everything :)
26
27## Installation
28
29To install **phpdbg**, you must compile the source against your PHP installation
30sources, and enable the SAPI with the configure command. It is enabled by
31default:
32
33```bash
34cd /path/to/php-src
35./buildconf --force
36./configure
37make -j8
38./sapi/phpdbg/phpdbg --version
39```
40
41Where the source directory has been used previously to build PHP, there exists a
42file named `config.nice` which can be used to invoke configure with the same
43parameters as were used by the last execution of `configure`.
44
45**Note:** PHP must be configured with the switch `--with-readline` for phpdbg to
46support history, autocompletion, tab-listing etc.
47
48## Command line options
49
50The following switches are implemented (just like cli SAPI):
51
52* `-n` ignore php ini
53* `-c` search for php ini in path
54* `-z` load zend extension
55* `-d` define php ini entry
56
57The following switches change the default behaviour of phpdbg:
58
59* `-v` disables quietness
60* `-s` enabled stepping
61* `-e` sets execution context
62* `-b` boring - disables use of colour on the console
63* `-I` ignore .phpdbginit (default init file)
64* `-i` override .phpgdbinit location (implies -I)
65* `-O` set oplog output file
66* `-q` do not print banner on startup
67* `-r` jump straight to run
68* `-E` enable step through eval()
69* `-l` listen ports for remote mode
70* `-a` listen address for remote mode
71* `-S` override SAPI name
72
73**Note:** Passing `-rr` will cause phpdbg to quit after execution, rather than
74returning to the console.
75
76## Getting started
77
78See the [website](https://phpdbg.room11.org) for tutorials/documentation.
79