php-src/sapi/phpdbg
Christoph M. Becker 85ac5643ff Fix INI setting member name
Since the member is not used in `OnUpdateEol()` that's not really an
issue, but still it's confusing to apparently have two INI settings
targeting the same member.
2020-05-19 15:59:21 +02:00
..
tests Merge branch 'PHP-7.2' into PHP-7.3 2019-07-16 11:10:51 +02:00
.gdbinit
.phpdbginit Trim trailing whitespace in source code files 2018-10-13 14:16:33 +02:00
Changelog.md
config.m4 Merge branch 'PHP-7.2' into PHP-7.3 2019-03-28 07:35:15 +01:00
config.w32 Sync leading and final newlines in source code files 2018-10-14 12:55:24 +02:00
create-test.php year++ 2018-01-02 12:57:58 +08:00
CREDITS
Makefile.frag Sync leading and final newlines in source code files 2018-10-14 12:55:24 +02:00
phpdbg_bp.c Merge branch 'PHP-7.2' into PHP-7.3 2019-03-27 00:02:31 +01:00
phpdbg_bp.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_break.c year++ 2018-01-02 12:57:58 +08:00
phpdbg_break.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_btree.c year++ 2018-01-02 12:57:58 +08:00
phpdbg_btree.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_cmd.c Fix #77805 phpdbg build fails when readline is shared 2019-03-27 10:02:42 +01:00
phpdbg_cmd.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_eol.c year++ 2018-01-02 12:57:58 +08:00
phpdbg_eol.h Sync leading and final newlines in source code files 2018-10-14 12:55:24 +02:00
phpdbg_frame.c Replace zval_dtor() with specialized destructors 2018-07-05 13:32:39 +03:00
phpdbg_frame.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_help.c Fix #77767: phpdbg break command help message shows incorrect aliases 2019-03-19 09:55:10 +01:00
phpdbg_help.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_info.c Pack zend_constant.flags and zend_constant.module_number into reserved space inside zend_constant.value. 2018-07-26 12:58:07 +03:00
phpdbg_info.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_io.c Sync leading and final newlines in source code files 2018-10-14 12:55:24 +02:00
phpdbg_io.h Sync leading and final newlines in source code files 2018-10-14 12:55:24 +02:00
phpdbg_lexer.c Regenerate scanners using re2c version >= 1.0.0 (newer version, at least, produce less code) 2018-07-25 12:49:03 +03:00
phpdbg_lexer.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_lexer.l Properly escape all filenames when exporting breakpoints 2016-11-13 13:22:06 +01:00
phpdbg_list.c Fixed bug #78297 2019-07-16 11:09:17 +02:00
phpdbg_list.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_opcode.c Avoid live range references in opcodes 2018-02-16 21:30:48 +01:00
phpdbg_opcode.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_out.c Replace legacy zval_dtor() by zval_ptr_dtor_nogc() or even more specialized destructors. 2018-07-04 19:22:24 +03:00
phpdbg_out.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_parser.c Trim trailing whitespace in source code files 2018-10-13 14:14:50 +02:00
phpdbg_parser.h Trim trailing whitespace in source code files 2018-10-13 14:14:50 +02:00
phpdbg_parser.y Remove unused PHP_PROG_LEX macro 2018-07-29 10:53:21 +02:00
phpdbg_print.c Trim trailing whitespace in source code files 2018-10-13 14:14:50 +02:00
phpdbg_print.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_prompt.c Merge branch 'PHP-7.2' into PHP-7.3 2019-03-27 10:04:07 +01:00
phpdbg_prompt.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_rinit_hook.c year++ 2018-01-02 12:57:58 +08:00
phpdbg_rinit_hook.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_set.c Trim trailing whitespace in source code files 2018-10-13 14:14:50 +02:00
phpdbg_set.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_sigio_win32.c Sync leading and final newlines in source code files 2018-10-14 12:55:24 +02:00
phpdbg_sigio_win32.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_sigsafe.c Sync leading and final newlines in source code files 2018-10-14 12:55:24 +02:00
phpdbg_sigsafe.h Fix issues with phpdbg SIGINT handler 2015-08-21 23:36:31 +01:00
phpdbg_utils.c Changed php_add[c]slashes prototypes (removed should_free argument) 2018-06-29 00:19:16 +03:00
phpdbg_utils.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_wait.c Use zval_ptr_dtor() imstead of zval_dtor() 2018-07-05 17:55:54 +03:00
phpdbg_wait.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_watch.c Trim trailing whitespace in source code files 2018-10-13 14:14:50 +02:00
phpdbg_watch.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_webdata_transfer.c Replace legacy zval_dtor() by zval_ptr_dtor_nogc() or even more specialized destructors. 2018-07-04 19:22:24 +03:00
phpdbg_webdata_transfer.h year++ 2018-01-02 12:57:58 +08:00
phpdbg_win.c year++ 2018-01-02 12:57:58 +08:00
phpdbg_win.h year++ 2018-01-02 12:57:58 +08:00
phpdbg.1.in Fix bug 76595: Update phpdbg man page 2018-08-04 06:34:40 +02:00
phpdbg.c Fix INI setting member name 2020-05-19 15:59:21 +02:00
phpdbg.h Merge branch 'PHP-7.2' into PHP-7.3 2019-03-27 10:04:07 +01:00
phpdbg.init.d Trim trailing whitespace in source code files 2018-10-13 14:16:33 +02:00
README.md Fix link for phpdbg documentation 2018-03-11 16:37:40 +01:00
test.php Merge sapi/phpdbg into PHP-5.6 2014-04-21 23:30:08 +02:00
web-bootstrap.php Trim trailing whitespace in source code files 2018-10-13 14:16:33 +02:00
xml.md Trim trailing whitespace in source code files 2018-10-13 14:16:33 +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+

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

https://phpdbg.room11.org