php-src/sapi/phpdbg
Peter Kokot 92ac598aab Remove local variables
This patch removes the so called local variables defined per
file basis for certain editors to properly show tab width, and
similar settings. These are mainly used by Vim and Emacs editors
yet with recent changes the once working definitions don't work
anymore in Vim without custom plugins or additional configuration.
Neither are these settings synced across the PHP code base.

A simpler and better approach is EditorConfig and fixing code
using some code style fixing tools in the future instead.

This patch also removes the so called modelines for Vim. Modelines
allow Vim editor specifically to set some editor configuration such as
syntax highlighting, indentation style and tab width to be set in the
first line or the last 5 lines per file basis. Since the php test
files have syntax highlighting already set in most editors properly and
EditorConfig takes care of the indentation settings, this patch removes
these as well for the Vim 6.0 and newer versions.

With the removal of local variables for certain editors such as
Emacs and Vim, the footer is also probably not needed anymore when
creating extensions using ext_skel.php script.

Additionally, Vim modelines for setting php syntax and some editor
settings has been removed from some *.phpt files.  All these are
mostly not relevant for phpt files neither work properly in the
middle of the file.
2019-02-03 21:03:00 +01:00
..
tests Sync leading and final newlines in *.phpt sections 2018-10-15 04:33:09 +02:00
.gdbinit
.phpdbginit Trim trailing whitespace in source code files 2018-10-13 14:17:28 +02:00
config.m4 Remove local variables 2019-02-03 21:03:00 +01:00
config.w32 Sync leading and final newlines in source code files 2018-10-14 12:56:38 +02:00
create-test.php Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
CREDITS
Makefile.frag Sync leading and final newlines in source code files 2018-10-14 12:56:38 +02:00
phpdbg.1.in Fix bug 76595: Update phpdbg man page 2018-08-04 06:34:40 +02:00
phpdbg.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg.init.d Trim trailing whitespace in source code files 2018-10-13 14:17:28 +02:00
phpdbg_bp.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_bp.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_break.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_break.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_btree.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_btree.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_cmd.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_cmd.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_eol.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_eol.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_frame.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_frame.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_help.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_help.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_info.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_info.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_io.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_io.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_lexer.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_lexer.l Properly escape all filenames when exporting breakpoints 2016-11-13 13:22:06 +01:00
phpdbg_list.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_list.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_opcode.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_opcode.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_out.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_out.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_parser.y Fixed build in directory different from source 2018-10-24 12:45:04 +03:00
phpdbg_print.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_print.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_prompt.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_prompt.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_rinit_hook.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_rinit_hook.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_set.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_set.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_sigio_win32.c Sync leading and final newlines in source code files 2018-10-14 12:56:38 +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:56:38 +02:00
phpdbg_sigsafe.h Fix issues with phpdbg SIGINT handler 2015-08-21 23:36:31 +01:00
phpdbg_utils.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_utils.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_wait.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_wait.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_watch.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_watch.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_webdata_transfer.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_webdata_transfer.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_win.c Remove yearly range from copyright notice 2019-01-30 11:03:12 +02:00
phpdbg_win.h Remove yearly range from copyright notice 2019-01-30 11:03:12 +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:17:28 +02:00
xml.md Trim trailing whitespace in source code files 2018-10-13 14:17:28 +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