mirror of
https://github.com/php/php-src.git
synced 2024-11-28 20:34:29 +08:00
b746e69887
This patch adds missing newlines, trims multiple redundant final newlines into a single one, and trims redundant leading newlines in all *.phpt sections. According to POSIX, a line is a sequence of zero or more non-' <newline>' characters plus a terminating '<newline>' character. [1] Files should normally have at least one final newline character. C89 [2] and later standards [3] mention a final newline: "A source file that is not empty shall end in a new-line character, which shall not be immediately preceded by a backslash character." Although it is not mandatory for all files to have a final newline fixed, a more consistent and homogeneous approach brings less of commit differences issues and a better development experience in certain text editors and IDEs. [1] http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_206 [2] https://port70.net/~nsz/c/c89/c89-draft.html#2.1.1.2 [3] https://port70.net/~nsz/c/c99/n1256.html#5.1.1.2 |
||
|---|---|---|
| .. | ||
| tests | ||
| .gdbinit | ||
| .phpdbginit | ||
| Changelog.md | ||
| config.m4 | ||
| config.w32 | ||
| create-test.php | ||
| CREDITS | ||
| Makefile.frag | ||
| phpdbg_bp.c | ||
| phpdbg_bp.h | ||
| phpdbg_break.c | ||
| phpdbg_break.h | ||
| phpdbg_btree.c | ||
| phpdbg_btree.h | ||
| phpdbg_cmd.c | ||
| phpdbg_cmd.h | ||
| phpdbg_eol.c | ||
| phpdbg_eol.h | ||
| phpdbg_frame.c | ||
| phpdbg_frame.h | ||
| phpdbg_help.c | ||
| phpdbg_help.h | ||
| phpdbg_info.c | ||
| phpdbg_info.h | ||
| phpdbg_io.c | ||
| phpdbg_io.h | ||
| phpdbg_lexer.c | ||
| phpdbg_lexer.h | ||
| phpdbg_lexer.l | ||
| phpdbg_list.c | ||
| phpdbg_list.h | ||
| phpdbg_opcode.c | ||
| phpdbg_opcode.h | ||
| phpdbg_out.c | ||
| phpdbg_out.h | ||
| phpdbg_parser.c | ||
| phpdbg_parser.h | ||
| phpdbg_parser.y | ||
| phpdbg_print.c | ||
| phpdbg_print.h | ||
| phpdbg_prompt.c | ||
| phpdbg_prompt.h | ||
| phpdbg_rinit_hook.c | ||
| phpdbg_rinit_hook.h | ||
| phpdbg_set.c | ||
| phpdbg_set.h | ||
| phpdbg_sigio_win32.c | ||
| phpdbg_sigio_win32.h | ||
| phpdbg_sigsafe.c | ||
| phpdbg_sigsafe.h | ||
| phpdbg_utils.c | ||
| phpdbg_utils.h | ||
| phpdbg_wait.c | ||
| phpdbg_wait.h | ||
| phpdbg_watch.c | ||
| phpdbg_watch.h | ||
| phpdbg_webdata_transfer.c | ||
| phpdbg_webdata_transfer.h | ||
| phpdbg_win.c | ||
| phpdbg_win.h | ||
| phpdbg.1.in | ||
| phpdbg.c | ||
| phpdbg.h | ||
| phpdbg.init.d | ||
| README.md | ||
| test.php | ||
| web-bootstrap.php | ||
| 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.
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