function _drupal_get_last_caller

7.x errors.inc _drupal_get_last_caller($backtrace)

Gets the last caller from a backtrace.

Parameters

$backtrace: A standard PHP backtrace.

Return value

An associative array with keys 'file', 'line' and 'function'.

5 calls to _drupal_get_last_caller()

DrupalTestCase::errorHandler in drupal-7.x/modules/simpletest/drupal_web_test_case.php: Handle errors during test runs.
DrupalTestCase::exceptionHandler in drupal-7.x/modules/simpletest/drupal_web_test_case.php: Handle exceptions.
DrupalTestCase::getAssertionCall in drupal-7.x/modules/simpletest/drupal_web_test_case.php: Cycles through backtrace until the first non-assertion method is found.
_drupal_decode_exception in drupal-7.x/includes/errors.inc: Decodes an exception and retrieves the correct caller.
_drupal_error_handler_real in drupal-7.x/includes/errors.inc: Provides custom PHP error handling.

File

drupal-7.x/includes/errors.inc, line 260: Functions for error handling.

Code

function _drupal_get_last_caller($backtrace) {
  // Errors that occur inside PHP internal functions do not generate
  // information about file and line. Ignore black listed functions.
  $blacklist = array('debug', '_drupal_error_handler', '_drupal_exception_handler');
  while (($backtrace && !isset($backtrace[0]['line'])) || 
    (isset($backtrace[1]['function']) && in_array($backtrace[1]['function'], $blacklist))) {
    array_shift($backtrace);
  }

  // The first trace is the call itself.
  // It gives us the line and the file of the last call.
  $call = $backtrace[0];

  // The second call give us the function where the call originated.
  if (isset($backtrace[1])) {
    if (isset($backtrace[1]['class'])) {
      $call['function'] = $backtrace[1]['class'] . $backtrace[1]['type'] . $backtrace[1]['function'] . '()';
    }
    else {
      $call['function'] = $backtrace[1]['function'] . '()';
    }
  }
  else {
    $call['function'] = 'main()';
  }
  return $call;
}