Skip to content

Latest commit

 

History

History
 
 

phpdbg

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
tests
tests
 
 
.gdbinit
.gdbinit
 
 
.phpdbginit
.phpdbginit
 
 
CREDITS
CREDITS
 
 
Makefile.frag
Makefile.frag
 
 
README.md
README.md
 
 
config.m4
config.m4
 
 
config.w32
config.w32
 
 
create-test.php
create-test.php
 
 
phpdbg.1.in
phpdbg.1.in
 
 
phpdbg.c
phpdbg.c
 
 
phpdbg.h
phpdbg.h
 
 
phpdbg.init.d
phpdbg.init.d
 
 
phpdbg_bp.c
phpdbg_bp.c
 
 
phpdbg_bp.h
phpdbg_bp.h
 
 
phpdbg_break.c
phpdbg_break.c
 
 
phpdbg_break.h
phpdbg_break.h
 
 
phpdbg_btree.c
phpdbg_btree.c
 
 
phpdbg_btree.h
phpdbg_btree.h
 
 
phpdbg_cmd.c
phpdbg_cmd.c
 
 
phpdbg_cmd.h
phpdbg_cmd.h
 
 
phpdbg_eol.c
phpdbg_eol.c
 
 
phpdbg_eol.h
phpdbg_eol.h
 
 
phpdbg_frame.c
phpdbg_frame.c
 
 
phpdbg_frame.h
phpdbg_frame.h
 
 
phpdbg_help.c
phpdbg_help.c
 
 
phpdbg_help.h
phpdbg_help.h
 
 
phpdbg_info.c
phpdbg_info.c
 
 
phpdbg_info.h
phpdbg_info.h
 
 
phpdbg_io.c
phpdbg_io.c
 
 
phpdbg_io.h
phpdbg_io.h
 
 
phpdbg_lexer.h
phpdbg_lexer.h
 
 
phpdbg_lexer.l
phpdbg_lexer.l
 
 
phpdbg_list.c
phpdbg_list.c
 
 
phpdbg_list.h
phpdbg_list.h
 
 
phpdbg_opcode.c
phpdbg_opcode.c
 
 
phpdbg_opcode.h
phpdbg_opcode.h
 
 
phpdbg_out.c
phpdbg_out.c
 
 
phpdbg_out.h
phpdbg_out.h
 
 
phpdbg_parser.y
phpdbg_parser.y
 
 
phpdbg_print.c
phpdbg_print.c
 
 
phpdbg_print.h
phpdbg_print.h
 
 
phpdbg_prompt.c
phpdbg_prompt.c
 
 
phpdbg_prompt.h
phpdbg_prompt.h
 
 
phpdbg_rinit_hook.c
phpdbg_rinit_hook.c
 
 
phpdbg_rinit_hook.h
phpdbg_rinit_hook.h
 
 
phpdbg_set.c
phpdbg_set.c
 
 
phpdbg_set.h
phpdbg_set.h
 
 
phpdbg_sigio_win32.c
phpdbg_sigio_win32.c
 
 
phpdbg_sigio_win32.h
phpdbg_sigio_win32.h
 
 
phpdbg_sigsafe.c
phpdbg_sigsafe.c
 
 
phpdbg_sigsafe.h
phpdbg_sigsafe.h
 
 
phpdbg_utils.c
phpdbg_utils.c
 
 
phpdbg_utils.h
phpdbg_utils.h
 
 
phpdbg_wait.c
phpdbg_wait.c
 
 
phpdbg_wait.h
phpdbg_wait.h
 
 
phpdbg_watch.c
phpdbg_watch.c
 
 
phpdbg_watch.h
phpdbg_watch.h
 
 
phpdbg_webdata_transfer.c
phpdbg_webdata_transfer.c
 
 
phpdbg_webdata_transfer.h
phpdbg_webdata_transfer.h
 
 
phpdbg_win.c
phpdbg_win.c
 
 
phpdbg_win.h
phpdbg_win.h
 
 
test.php
test.php
 
 
web-bootstrap.php
web-bootstrap.php
 
 
xml.md
xml.md
 
 

README.md

The interactive PHP debugger

Implemented as a SAPI module, phpdbg can exert complete control over the environment without impacting the functionality or performance of your code.

phpdbg aims to be a lightweight, powerful, easy to use debugging platform for PHP 5.4+.

Features

  • Stepthrough Debugging
  • Flexible Breakpoints (Class Method, Function, File:Line, Address, Opcode)
  • Easy Access to PHP with built-in eval()
  • Easy Access to Currently Executing Code
  • Userland API
  • SAPI Agnostic - Easily Integrated
  • PHP Configuration File Support
  • JIT Super Globals - Set Your Own!!
  • Optional readline Support - Comfortable Terminal Operation
  • Remote Debugging Support - Bundled Java GUI
  • Easy Operation - See Help

Planned

  • Improve Everything :)

Installation

To install phpdbg, you must compile the source against your PHP installation sources, and enable the SAPI with the configure command. It is enabled by default:

cd /path/to/php-src
./buildconf --force
./configure
make -j8
./sapi/phpdbg/phpdbg --version

Where 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 parameters as were used by the last execution of configure.

Note: PHP must be configured with the switch --with-readline for phpdbg to support history, autocompletion, tab-listing etc.

Command line options

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()
  • -l listen ports for remote mode
  • -a listen address for remote mode
  • -S override SAPI name

Note: Passing -rr will cause phpdbg to quit after execution, rather than returning to the console.

Getting started

See the website for tutorials/documentation.