Skip to content
Snippets Groups Projects
Name Last commit Last update
..
sapi/phpdbg/tests
sapi/phpdbg/.gdbinit
sapi/phpdbg/.phpdbginit
sapi/phpdbg/CREDITS
sapi/phpdbg/Makefile.frag
sapi/phpdbg/README.md
sapi/phpdbg/config.m4
sapi/phpdbg/config.w32
sapi/phpdbg/create-test.php
sapi/phpdbg/phpdbg.1.in
sapi/phpdbg/phpdbg.c
sapi/phpdbg/phpdbg.h
sapi/phpdbg/phpdbg.init.d
sapi/phpdbg/phpdbg_bp.c
sapi/phpdbg/phpdbg_bp.h
sapi/phpdbg/phpdbg_break.c
sapi/phpdbg/phpdbg_break.h
sapi/phpdbg/phpdbg_btree.c
sapi/phpdbg/phpdbg_btree.h
sapi/phpdbg/phpdbg_cmd.c
sapi/phpdbg/phpdbg_cmd.h
sapi/phpdbg/phpdbg_eol.c
sapi/phpdbg/phpdbg_eol.h
sapi/phpdbg/phpdbg_frame.c
sapi/phpdbg/phpdbg_frame.h
sapi/phpdbg/phpdbg_help.c
sapi/phpdbg/phpdbg_help.h
sapi/phpdbg/phpdbg_info.c
sapi/phpdbg/phpdbg_info.h
sapi/phpdbg/phpdbg_io.c
sapi/phpdbg/phpdbg_io.h
sapi/phpdbg/phpdbg_lexer.c
sapi/phpdbg/phpdbg_lexer.h
sapi/phpdbg/phpdbg_lexer.l
sapi/phpdbg/phpdbg_list.c
sapi/phpdbg/phpdbg_list.h
sapi/phpdbg/phpdbg_opcode.c
sapi/phpdbg/phpdbg_opcode.h
sapi/phpdbg/phpdbg_out.c
sapi/phpdbg/phpdbg_out.h
sapi/phpdbg/phpdbg_parser.c
sapi/phpdbg/phpdbg_parser.h
sapi/phpdbg/phpdbg_parser.output
sapi/phpdbg/phpdbg_parser.y
sapi/phpdbg/phpdbg_print.c
sapi/phpdbg/phpdbg_print.h
sapi/phpdbg/phpdbg_prompt.c
sapi/phpdbg/phpdbg_prompt.h
sapi/phpdbg/phpdbg_rinit_hook.c
sapi/phpdbg/phpdbg_rinit_hook.h
sapi/phpdbg/phpdbg_set.c
sapi/phpdbg/phpdbg_set.h
sapi/phpdbg/phpdbg_sigio_win32.c
sapi/phpdbg/phpdbg_sigio_win32.h
sapi/phpdbg/phpdbg_sigsafe.c
sapi/phpdbg/phpdbg_sigsafe.h
sapi/phpdbg/phpdbg_utils.c
sapi/phpdbg/phpdbg_utils.h
sapi/phpdbg/phpdbg_wait.c
sapi/phpdbg/phpdbg_wait.h
sapi/phpdbg/phpdbg_watch.c
sapi/phpdbg/phpdbg_watch.h
sapi/phpdbg/phpdbg_webdata_transfer.c
sapi/phpdbg/phpdbg_webdata_transfer.h
sapi/phpdbg/phpdbg_win.c
sapi/phpdbg/phpdbg_win.h
sapi/phpdbg/test.php
sapi/phpdbg/web-bootstrap.php
sapi/phpdbg/xml.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.