debug_backtrace() from registered shutdown function in PHP

Dan Lugg picture Dan Lugg · Aug 30, 2011 · Viewed 9.3k times · Source

While tinkering for an answer to this question, I found that debug_backtrace() doesn't trace beyond the function registered to register_shutdown_function(), when called from within it.

This was mentioned in this comment for register_shutdown_function() in the PHP docs, stating:

You may get the idea to call debug_backtrace or debug_print_backtrace from inside a shutdown function, to trace where a fatal error occurred. Unfortunately, these functions will not work inside a shutdown function.

Explained with a bit more detail, comments on this answer state:

Doesn't work. The shutdown function occurs after the stack has unwinded. There is no stack information to dump.

Is there any way to circumvent this, forcing PHP to hold the stack trace until the process has terminated altogether, or should we accept it as a given due to PHP internals?

Answer

powtac picture powtac · Aug 30, 2011

This is a very expensive solution. I never used register_tick_function() or tick and I'm not sure if it works as expected.

declare(ticks=1);

function tick_handler() {
    global $backtrace;
    $backtrace = debug_backtrace();
}
register_tick_function('tick_handler');



function shutdown() {
    global $backtrace;
    // do check if $backtrace contains a fatal error...
    var_dump($backtrace);
}
register_shutdown_function('shutdown');