function DatabaseLog::findCaller

Determine the routine that called this query.

We define "the routine that called this query" as the first entry in the call stack that is not inside includes/database and does have a file (which excludes call_user_func_array(), anonymous functions and similar). That makes the climbing logic very simple, and handles the variable stack depth caused by the query builders.

@link http://www.php.net/debug_backtrace

Return value

This method returns a stack trace entry similar to that generated by debug_backtrace(). However, it flattens the trace entry and the trace entry before it so that we get the function and args of the function that called into the database system, not the function and args of the database call itself.

1 call to DatabaseLog::findCaller()
DatabaseLog::log in includes/database/log.inc
Log a query to all active logging keys.

File

includes/database/log.inc, line 144

Class

DatabaseLog
Database query logger.

Code

public function findCaller() {
    $stack = debug_backtrace();
    $stack_count = count($stack);
    for ($i = 0; $i < $stack_count; ++$i) {
        if (!empty($stack[$i]['file']) && strpos($stack[$i]['file'], 'includes' . DIRECTORY_SEPARATOR . 'database') === FALSE) {
            $stack[$i] += array(
                'args' => array(),
            );
            return array(
                'file' => $stack[$i]['file'],
                'line' => $stack[$i]['line'],
                'function' => $stack[$i + 1]['function'],
                'class' => isset($stack[$i + 1]['class']) ? $stack[$i + 1]['class'] : NULL,
                'type' => isset($stack[$i + 1]['type']) ? $stack[$i + 1]['type'] : NULL,
                'args' => $stack[$i + 1]['args'],
            );
        }
    }
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.