mirror of https://github.com/php/php-src.git synced 2024-09-22 18:37:25 +00:00

The PHP Interpreter

Go to file

krakjoe ef86b57f3b Merge branch 'master' of https://github.com/krakjoe/phpdbg into lexer Conflicts: phpdbg_prompt.c		2014-04-13 08:06:42 +01:00
dev	fix addr parameters	2014-04-13 08:06:21 +01:00
tests	In english, no horizontal space before “!”.	2013-12-18 11:53:30 +01:00
travis	travis	2013-12-05 22:59:34 +00:00
.gdbinit	- Added .gdbinit	2013-11-14 10:40:01 -02:00
.gitignore	...	2013-11-29 09:38:00 +00:00
.phpdbginit	consistent in ___ for info/print	2013-11-25 10:17:57 +00:00
.travis.yml	travis	2013-12-05 22:59:34 +00:00
Changelog.md	update cl	2013-12-09 09:49:50 +00:00
config.m4	Merge branch 'master' of https://github.com/krakjoe/phpdbg into lexer	2014-02-18 08:40:42 +00:00
config.w32	fix #75 phpdbg disabled by default	2014-02-18 08:40:33 +00:00
CREDITS	reformat	2013-12-23 21:54:45 +00:00
Makefile.frag	Tiny whitespace fix in makefile (aligning with other "Installing" messages)	2013-12-09 19:58:19 +01:00
phpdbg_bp.c	Merge branch 'master' of https://github.com/krakjoe/phpdbg into lexer	2014-04-13 08:06:42 +01:00
phpdbg_bp.h	remove input_t	2014-02-19 08:33:54 +00:00
phpdbg_break.c	do not allow abbreivation of anything without alias, fixes input for sh/ev	2014-02-21 21:31:01 +00:00
phpdbg_break.h	introduce proper support for file:#opline	2014-02-21 18:01:50 +00:00
phpdbg_cmd.c	fix ts build	2014-02-24 09:26:03 +00:00
phpdbg_cmd.h	fix ts build	2014-02-24 09:26:03 +00:00
phpdbg_frame.c	Fixed frame number order	2014-04-12 22:08:02 +02:00
phpdbg_frame.h	Update year	2014-01-17 23:09:07 +01:00
phpdbg_help.c	Merge branch 'master' of https://github.com/krakjoe/phpdbg into lexer	2014-04-13 08:06:42 +01:00
phpdbg_help.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_info.c	work on lexer to be more permissive (accept moar strings)	2014-02-19 20:18:49 +00:00
phpdbg_info.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_lexer.c	fix addr parameters	2014-04-13 08:06:21 +01:00
phpdbg_lexer.h	parse stream locations properly, bp.c still needs work for #82	2014-02-28 07:41:34 +00:00
phpdbg_list.c	use php streams to handle line endings better for #81	2014-02-27 19:10:59 +00:00
phpdbg_list.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_opcode.c	Retain full compability for all micro versions since PHP 5.4	2014-04-12 18:00:33 +02:00
phpdbg_opcode.h	Update year	2014-01-17 23:09:07 +01:00
phpdbg_parser.c	parse stream locations properly, bp.c still needs work for #82	2014-02-28 07:41:34 +00:00
phpdbg_parser.h	parse stream locations properly, bp.c still needs work for #82	2014-02-28 07:41:34 +00:00
phpdbg_print.c	moar cleanup	2014-02-21 20:46:56 +00: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' of https://github.com/krakjoe/phpdbg into lexer	2014-04-13 08:06:42 +01:00
phpdbg_prompt.h	export command	2014-02-24 19:03:55 +00:00
phpdbg_set.c	set colors working	2014-02-23 07:33:48 +00:00
phpdbg_set.h	work on lexer to be more permissive (accept moar strings)	2014-02-19 20:18:49 +00:00
phpdbg_utils.c	fix ts build	2014-02-24 09:26:03 +00:00
phpdbg_utils.h	set colors working	2014-02-23 07:33:48 +00:00
phpdbg.c	Merge branch 'master' of https://github.com/krakjoe/phpdbg into lexer	2014-04-13 08:06:42 +01:00
phpdbg.h	...	2014-02-21 18:52:06 +00:00
phpdbg.init.d	WS	2013-12-08 21:58:01 +01:00
README.md	update readme	2013-12-20 13:20:17 +00:00
test.php	moar params for registered functions	2014-02-24 22:30:46 +00:00
web-bootstrap.php	update bootstrap	2013-11-16 15:37:00 +00:00

README.md

The interactive PHP debugger

Implemented as a SAPI module, phpdbg can excert 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

http://phpdbg.com