Nikita Popov
c3132781ec
In particular, make sure that everything using zmm is released before zmm is shut down. phpdbg currently gets away with this, because either a) its custom handlers are used and no auto-free happens or b) the system allocator is used and no auto-free happens. With the tracking allocator for asan this no longer works.
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. It is enabled by default:
cd /path/to/php-src
./buildconf --force
./configure
make -j8
./sapi/phpdbg/phpdbg --version
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):
-nignore php ini-csearch for php ini in path-zload zend extension-ddefine php ini entry
The following switches change the default behaviour of phpdbg:
-vdisables quietness-senabled stepping-esets execution context-bboring - disables use of colour on the console-Iignore .phpdbginit (default init file)-ioverride .phpgdbinit location (implies -I)-Oset oplog output file-qdo not print banner on startup-rjump straight to run-Eenable step through eval()-llisten ports for remote mode-alisten address for remote mode-Soverride 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.