Xdebug  
  XDEBUG EXTENSION FOR PHP | UPDATES
home | updates | installation | documentation | screenshots | license | support

UPDATES
[29-11-2004]

Added new features

DBGP: Added error messages to returned errors (in most cases)

Added new functions

xdebug_debug_zval() to debug zvals by printing its refcounts and is_ref values.

Changed features

xdebug_code_coverage_stop() will now clean up the code coverage array, unless you specify FALSE as parameter.
The proper Xdebug type is "hash" for associative arrays.
Extended the code-coverage functionality by returning lines with executable code on them, but where not executed with a count value of -1.

Fixed bugs

DBGP: Make property_get and property_value finally work as they should, including retrieving information from different depths then the most top stack frame.
DBGP: Fix eval'ed $varnames in property_get.
DBGP: Support the -d option for property_get.
Fixed the exit handler hook to use the new "5.1" way of handling it; which fortunately also works with PHP 5.0.
Fixed bug #102: Problems with configure for automake 1.8.
Fixed bug #101: crash with set_exeception_handler() and uncatched exceptions.
Fixed bug #99: unset variables return the name as a string with property_get.
Fixed bug #98: 'longname' attribute not returned for unintialized property in context_get request.
Fixed bug #94: xdebug_sprintf misbehaves with x86_64/glibc-2.3.3
Fixed bug #93: Crash in lookup_hostname on x86_64
Fixed bug #92: xdebug_disable() doesn't disable the exception handler.
Fixed bug #68: Summary not written when script ended with "exit()".
[15-09-2004]

Added new features

Added support for the new DBGp protocol for communicating with the debug engine.
A computerized trace format for easier parsing by external programs.
The ability to set remote debugging features via the environment. This allows an IDE to emulate CGI and still pass the configuration through to the debugger. In CGI mode, PHP does not allow -d arguments.
Reimplementation of the tracing code, you can now only trace to file; this greatly enhances performance as no string representation of variables need to be kept in memory any more.
Re-implemented profiling support. Xdebug outputs information the same way that cachegrind does so it is possible to use Kcachegrind as front-end.
Xdebug emits warnings when it was not loaded as a Zend extension.
Added showing private, protected and public to the fancy var_dump() replacement function.
Added the setting of the TCP_NODELAY socket option to stop delays in transferring data to the remote debugger client. (Patch by Christof J. Reetz)
DebugClient: Added setting for port to listen on and implemented running the previous command when pressing just enter.

Added new functions

xdebug_get_stack_depth() to return the current stack depth level.
xdebug_get_tracefile_name() to retrieve the name of the tracefile. This is useful in case auto trace is enabled and you want to clean the trace file.
xdebug_peak_memory_usage() which returns the peak memory used in a script. (Only works when --enable-memory-limit was enabled)

Added feature requests

FR #5: xdebug_break() function which interupts the script for the debug engine.
FR #30: Dump current scope information in stack traces on error.
FR #88: Make the url parameter XDEBUG_SESSION_START optional. So it can be disabled and the user does not need to add it.

Added new php.ini settings

xdebug.auto_trace_file: to configure a trace file to write to as addition to the xdebug.auto_trace setting which just turns on tracing.
xdebug.collect_includes: separates collecting names of include files from the xdebug.collect_params setting.
xdebug.collect_return: showing return values in traces.
xdebug.dump_global: with which you can turn off dumping of super globals even in you have that configured.
xdebug.extended_info: turns off the generation of extended opcodes that are needed for stepping and breakpoints for the remote debugger. This is useful incase you want to profile memory usage as the generation of this extended info increases memory usage of oparrrays by about 33%.
xdebug.profiler_output_dir: profiler output directory.
xdebug.profiler_enable: enable the profiler.
xdebug.show_local_vars: turn off the showing of local variables in the top most stack frame on errors.
xdebug.show_mem_delta: show differences between current and previous memory usage on a function call level.
xdebug.trace_options: to configure extra options for trace dumping: o XDEBUG_TRACE_APPEND option (1)

Changed features

xdebug_start_trace() now returns the filename of the tracefile (.xt is added to the requested name).
Changed default debugging protocol to dbgp instead of gdb.
Changed default debugger port from 17869 to 9000.
Changed trace file naming: xdebug.trace_output_dir is now used to configure a directory to dump automatic traces; the trace file name now also includes the pid (xdebug.trace_output_name=pid) or a crc32 checksum of the current working dir (xdebug.trace_output_name=crc32) and traces are not being appended to an existing file anymore, but simply overwritten.
Removed $this and $GLOBALS from showing variables in the local scope.

Removed functions

xdebug_get_function_trace/xdebug_dump_function_trace() because of the new idea of tracing.

Fixed bugs

Fixed bug #89: var_dump shows empty strings garbled.
Fixed bug #85: Xdebug segfaults when no idekey is set.
Fixed bug #83: More than 32 parameters functions make xdebug crash.
Fixed bug #75: xdebug's var_dump implementation is not binary safe.
Fixed bug #73: komodo beta 4.3.7 crash.
Fixed bug #72: breakpoint_get returns wrong structure.
Fixed bug #69: Integer overflow in cachegrind summary.
Fixed bug #67: Filenames in Xdebug break URI RFC with spaces.
Fixed bug #64: Missing include of xdebug_compat.h.
Fixed bug #57: Crash with overloading functions.
Fixed bug #54: source command did not except missing -f parameter.
Fixed bug #53: Feature get misusing the supported attribute.
Fixed bug #51: Only start a debug session if XDEBUG_SESSION_START is passed as GET or POST parameter, or the DBGP_COOKIE is send to the server. Passing XDEBUG_SESSION_STOP as GET/POST parameter will end the debug session and removes the cookie again. The cookie is also passed to the remote handler backends; for DBGp it is added to the packet.
Fixed bug #49: Included file's names should not be stored by address.
Fixed bug #44: Script time-outs should be disabled when debugging.
Fixed bug #36: GDB handler using print causes segfault with wrong syntax
Fixed bug #33: Implemented the use of the ZEND_POST_DEACTIVATE hook. Now we can handle destructors safely too.
Fixed bug #32: Unusual dynamic variables cause xdebug to crash.
[26-12-2003]
GDB: Added file/line to signals.
Fixed logging to adhere to the error_reporting setting.
Fixed bug #32: Unusual dynamic variables cause xdebug to crash.
Fixed bug #31: & entity replaced after others, wrong HTML output.
Fixed bug #22: Segmentation fault with xdebug_get_function_stack() and collect_params=1.
[08-11-2003]
Added version info to handlers which show in phpinfo() output.
GDB: Fixed bug with continuing after breakpoint where only 'cont' worked.
GDB: Fixed bug in deleting absolute breakpoints on Windows.
Fixed bug #27: Repeated connect attempts when no debugger is listening.
Fixed bug #19: The value of xdebug.output_dir in a .htaccess never takes effect.
Fixed bug #18: Mistyped sizeof()'s for array indexes in profiler output.
Fixed handling stack traces for when display_errors was set to Off.
Fixed segfault where a function name didn't exist in case of a "call_user_function".
Fixed reading a filename in case of an callback to a PHP function from an internal function (like "array_map()").
[18-09-2003]
Fixed bug with wrong file names for functions called from call_user_*().
[30-08-2003]
Added the option "dump_superglobals" to the remote debugger. If you set this option to 0 the "show-local" and similar commands will not return any data from superglobals anymore.
[30-08-2003]
Fixed bug #2: "pear package" triggers a segfault.
Fixed crash bug when a function had sprintf style parameters (ie. strftime()).
[16-07-2003]
Added "id" attribute to <var /> elements in responses from the remove debugger when the response method is XML. This makes it possible to distinguish between unique elements by use of recursion for example.
Greatly cut down on the overhead that Xdebug causes on running scripts.
Fixed a bug with "quit" that would disable the extension.
Fixed a bug in the folding of recursive elements.
[03-07-2003]
Implemented an argument to the "bt" command. If this is set to "full" all local variables for a stack frame are showed too.
[28-06-2003]
Updated licence: "PHP Licence" was renamed to "Xdebug Licence", "The PHP Group" to "Derick Rethans" and "PHP" to "Xdebug".
Added the xdebug_time_index() function which returns the time index since the start of the script.
[23-06-2003]
Updated licence: "PHP Licence" was renamed to "Xdebug Licence", "The PHP Group" to "Derick Rethans" and "PHP" to "Xdebug".
Implemented the "show-breakpoints" command which shows all currently active breakpoints including conditions.
[14-05-2003]
Implemented the "show-local" command (shows all local variables in the current scope including all contents) and conditions for breakpoints in the "break" command.
[27-04-2003]
Added a fancy replacement function for var_dump which overloads the standard PHP function while HTML errors are enabled.
[21-04-2003]
Added the xdebug_call_class function as addition to xdebug_call_function.
[19-04-2003]
Re-implemented the maximum nesting level protection.
[18-04-2003]
Turned off xdebug.collect_params by default.
Fix problems with symbols on MacOSX.
[14-04-2003]
Fixed handling pathnames and files under Windows for the debugger.
[10-04-2003]
Fixed accessing of superglobal variables from the debugger client.
[06-04-2003]
Fixed a segfault that happened while dealing with include files with ZE2.
[05-04-2003]
Allow remote debugging to be enabled in httpd.conf and .htaccess files.
Added code coverage, enable with xdebug_start_code_coverage(), disable with xdebug_stop_code_coverage() and get the information with xdebug_get_code_coverage(). The latter returns an array with each element being an array containing the lines and the number of times a statement was run on that line, per executed file.
[14-02-2003]
Added dumping of super globals when an error occurs.
[27-01-2003]
Added an XML transport layer for the remote debugger.
[22-01-2003]
Fixed handling of 'continue' (in addition to 'cont').
[14-01-2003]
Updated Xdebug to support Zend Engine 2 (PHP 5.0.0-dev).
[07-01-2003]
Implemented the "eval" (evalutes PHP code) to the remote debugger.
[05-01-2003]
Enabled support for Windows again.
directing profiling output to
[20-12-2002]
Fixed the "init" state of the debugger, from now on you can print data (like environment variables) from this state.
The array returned by get_function_trace() now includes the memory footprint and timing information.
[08-12-2002]
Automatic profiling added, including redirecting profiling output to disk.
[29-11-2002]
Added a new profiling mode: Stack-Dump.
[27-11-2002]
Basic profiling added to Xdebug, including three new functions: xdebug_start_profiling() that begins profiling process, xdebug_stop_profiling() that ends the profiling process and xdebug_dump_function_trace() that dumps the profiling data.
[15-11-2002]
Implemented the "kill" (kills the running script) and "delete" (deletes an already set breakpoint) command for the remote debugger.
[13-11-2002]
Parameters to functions are no longer recorded by default; use the xdebug.collect_params=1 setting in php.ini to turn it on again.
[12-11-2002]
Made the xdebug server and client working under Windows.
[09-11-2002]
Implemented the "next" (step over) and "finish" (step out) commands for the remote debugger.
[07-11-2002]
Lots of small bugfixes, under them memory leaks and crash bugs.
[03-11-2002]
Implemented the "list" (source listing), "print" (printing variable contents), "show" (show all variables in the scope), "step" (step through execution) and "pwd" (print working directory) commands to the remote debugger.
[29-10-2002]
Implemented class::method, object->method and file.ext:line style breakpoints.
Changed debugger port from 7869 to 17869.
[28-10-2002]
Added xdebug.collect_params setting. If this setting is on (the default) then Xdebug collects all parameters passed to functions, otherwise they are not collected at all.
Implemented correct handling of include/require and eval.
[22-10-2002]
Fixed bug which caused wrong filenames to be reported.
[18-10-2002]
Added automatic starting of function traces (xdebug.auto_trace, defaulting to "off").
Xdebug no longer supports PHP versions below PHP 4.3.0pre1.
Added gdb compatible debugger handler with support for simple (function only) breakpoints.
[16-09-2002]
Fixed bug with argument lists.
[04-09-2002]
Implemented remote debugger handler abstraction.
Added a php3 compatible debugger handler.
[01-09-2002]
Fixed memory footprint readings by not counting memory used by xdebug.
[30-08-2002]
Implemented gathering of parameters to internal functions. (Only works with recent PHP 4.3.0-dev versions!)
[28-08-2002]
Bugs, better performance and update of the xdebug_get_function_trace().
[27-08-2002]
Add much better routine for getting data from Zend.
[23-06-2002]
Xdebug no longer relies on PHP's output buffering mechanism. This caused problems with PEAR.
[16-06-2002]
Added PECL package.xml file to make xdebug installable by PEAR.
Flush the log file after every line during function tracing to file.
Removed the xdebug_* functions from the returned/showed function stracks and traces.
[09-06-2002]
Rewrote xdebug_get_function_stack() and xdebug_get_function_trace() to return data in multidimensional arrays.
[06-06-2002]
Add support for classnames, variable include files and variable function names.
Implemented links to the PHP Manual in traces.
Added timestamps and memory usage to function traces
[02-06-2002]
Fixed a crash when using user defined session handlers.
[29-05-2002]
Implemented variable function names.
[26-05-2002]
Unify showing unknown data.
[25-05-2002]
Implemented much better parameter tracing for user defined functions.
[18-05-2002]
Renamed xdebug_get_function_trace() to xdebug_dump_function_trace().
Implemented new xdebug_get_function_trace() to return the function trace in an array.
Added a parameter to xdebug_start_trace(). When this parameter is used, xdebug will dump a function trace to the filename which this parameter speficies.Fixed functions as parameters to functions
[17-05-2002]
Fixed functions as parameters to functions
[15-05-2002]
Fix logging to the systemlog
[14-05-2002]
Make xdebug respect the value of the error_reporting setting
[12-05-2002]
Added handling single-dimensional constant arrays as parameter to functions
[11-05-2002]
Implemented function traces (xdebug_start_trace(), xdebug_stop_trace() and xdebug_get_function_trace())
Added support for Windows to xdebug
[08-05-2002]
Implemented handling of static method calls (foo::bar())
[07-05-2002]
Implemented correct handling of include(), require() and eval()
[06-05-2002]
Fix removal of elements from the stack
[03-05-2002]
Added ini_settings and functions to disable and enable showing stacktraces from within your PHP script
[02-05-2002]
Added xdebug_memory_usage() which returns the amount of memory used by the PHP script


 
RELEASES
[29-11-2004]
Source:
Debug client 0.8.0 (binary):
[15-09-2004]
Windows modules:
[30-06-2004]
Source:
Modules for 4.3.x (binary):
Debug client 0.7.0 (binary):

DEVELOPMENT VERSION (2.0dev)
Instructions to get Xdebug 2.0dev from CVS can be found here. This version compiles on PHP 4.3.0 and higher.

BINARY SNAPSHOTS (2.0dev)
Modules for 4.3.x-dev:
Modules for 5.0.x-dev:
Modules for 5.1.x-dev:

OLDER RELEASES
Source:

 
 
This site and all of its contents are Copyright © 2002, 2003, 2004 by Derick Rethans.
All rights reserved.