The PHP Interpreter
Go to file
Bob Weinand 8bc2881260 Merge branch 'master' into xml-protocol
Conflicts:
	phpdbg.c
	phpdbg.h
	phpdbg_cmd.c
	phpdbg_cmd.h
	phpdbg_frame.c
	phpdbg_info.c
	phpdbg_list.c
	phpdbg_print.c
	phpdbg_prompt.c
	phpdbg_utils.c
	phpdbg_utils.h
	phpdbg_watch.c
2014-10-07 13:08:30 +02:00
tests Fix tests 2014-09-25 01:29:08 +02:00
travis Fixed order in travis script 2014-06-12 00:18:47 +03:00
.gdbinit - Added .gdbinit 2013-11-14 10:40:01 -02:00
.gitignore Updated parser & leer to be usable with re2c 2014-06-08 20:34:30 +00:00
.phpdbginit consistent in ___ for info/print 2013-11-25 10:17:57 +00:00
.travis.yml Don't run travis against master (phpng) 2014-09-10 15:57:05 +02:00
Changelog.md update cl 2013-12-09 09:49:50 +00:00
config.m4 Add transfer of output back to webserver and merge master in 2014-10-04 23:21:34 +02:00
config.w32 removed /EHa as __try/__catch syntax is used anyway 2014-04-26 00:07:13 +02:00
CREDITS reformat 2013-12-23 21:54:45 +00:00
Makefile.frag Fix phpdbg.1 man page installation when build != src directory 2014-07-05 13:05:05 +01:00
phpdbg_bp.c Consistency in breakpoint tags, <run> => <stop> 2014-10-05 12:33:24 +02:00
phpdbg_bp.h First draft of an xml protocol 2014-09-21 04:17:19 +02:00
phpdbg_break.c Made some functions async safe and provide interactive shell in signal handler 2014-10-03 01:29:41 +02:00
phpdbg_break.h introduce proper support for file:#opline 2014-02-21 18:01:50 +00:00
phpdbg_btree.c Fix readline/libedit (Thanks to @remicollet) 2014-06-29 11:26:03 +02:00
phpdbg_btree.h Fix readline/libedit (Thanks to @remicollet) 2014-06-29 11:26:03 +02:00
phpdbg_cmd.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_cmd.h Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_frame.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_frame.h Update year 2014-01-17 23:09:07 +01:00
phpdbg_help.c Merge branch 'master' into xml-protocol 2014-09-23 16:51:18 +02:00
phpdbg_help.h First draft of an xml protocol 2014-09-21 04:17:19 +02:00
phpdbg_info.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_info.h Add info globals command 2014-09-23 16:48:37 +02:00
phpdbg_lexer.c Add request_id possibility for xml output 2014-10-06 11:26:08 +02:00
phpdbg_lexer.h Updated parser & leer to be usable with re2c 2014-06-08 20:34:30 +00:00
phpdbg_lexer.l Add request_id possibility for xml output 2014-10-06 11:26:08 +02:00
phpdbg_list.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_list.h Made some functions async safe and provide interactive shell in signal handler 2014-10-03 01:29:41 +02:00
phpdbg_opcode.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_opcode.h Update year 2014-01-17 23:09:07 +01:00
phpdbg_parser.c Add request_id possibility for xml output 2014-10-06 11:26:08 +02:00
phpdbg_parser.h Add request_id possibility for xml output 2014-10-06 11:26:08 +02:00
phpdbg_parser.y Add request_id possibility for xml output 2014-10-06 11:26:08 +02:00
phpdbg_print.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_print.h Work in progress chekpoint of changes to help module. To allow peer review and feedback 2014-02-02 16:35:28 +00:00
phpdbg_prompt.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_prompt.h Add transfer of output back to webserver and merge master in 2014-10-04 23:21:34 +02:00
phpdbg_rinit_hook.c Add transfer of output back to webserver and merge master in 2014-10-04 23:21:34 +02:00
phpdbg_rinit_hook.h Fix segfaults, reorder files and set filename to exec 2014-09-10 16:03:26 +02:00
phpdbg_set.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_set.h step by line and opcode modes preserved, set stepping added, help updated 2014-04-20 18:46:35 +01:00
phpdbg_sigsafe.c Made some functions async safe and provide interactive shell in signal handler 2014-10-03 01:29:41 +02:00
phpdbg_sigsafe.h Made some functions async safe and provide interactive shell in signal handler 2014-10-03 01:29:41 +02:00
phpdbg_utils.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_utils.h Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_wait.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_wait.h Fix segfaults, reorder files and set filename to exec 2014-09-10 16:03:26 +02:00
phpdbg_watch.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg_watch.h Made some functions async safe and provide interactive shell in signal handler 2014-10-03 01:29:41 +02:00
phpdbg_webdata_transfer.c Add transfer of output back to webserver and merge master in 2014-10-04 23:21:34 +02:00
phpdbg_webdata_transfer.h Fix segfaults, reorder files and set filename to exec 2014-09-10 16:03:26 +02:00
phpdbg_win.c Remove some dead code... 2014-04-13 13:33:07 +02:00
phpdbg_win.h Cleanup 2014-03-16 20:04:08 +01:00
phpdbg.1 Merge branch 'master' of https://github.com/oerdnj/phpdbg into master 2014-06-25 13:31:24 +02:00
phpdbg.c Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg.h Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
phpdbg.init.d WS 2013-12-08 21:58:01 +01:00
README.md Update README.md 2014-07-17 15:43:24 +01:00
test.php Made refcount info switchable by set refcount on/off. Default: off 2014-04-14 19:37:31 +02:00
web-bootstrap.php update bootstrap 2013-11-16 15:37:00 +00:00
xml.md Merge branch 'master' into xml-protocol 2014-10-07 13:08:30 +02:00
zend_mm_structs.h Send a \x03 during execution to interrupt (POSIX only) 2014-09-28 02:57:12 +02:00

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+

phpdbg on travis-ci

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.

cd /usr/src/php-src/sapi
git clone https://github.com/krakjoe/phpdbg
cd ../
./buildconf --force
./configure --enable-phpdbg
make -j8
make install-phpdbg

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

http://phpdbg.com