function _drupal_decode_exception

7.x _drupal_decode_exception($exception)

Decodes an exception and retrieves the correct caller.


$exception: The exception object that was thrown.

Return value

An error in the format expected by _drupal_log_error().

5 calls to _drupal_decode_exception()
DrupalTestCase::exceptionHandler in drupal-7.x/modules/simpletest/drupal_web_test_case.php
Handle exceptions.
update_do_one in drupal-7.x/includes/
Performs one update and stores the results for display on the results page.
watchdog_exception in drupal-7.x/includes/
Logs an exception.
_drupal_exception_handler in drupal-7.x/includes/
Provides custom PHP exception handling.
_drupal_render_exception_safe in drupal-7.x/includes/
Renders an exception error message without further exceptions.


drupal-7.x/includes/, line 88
Functions for error handling.


function _drupal_decode_exception($exception) {
  $message = $exception->getMessage();

  $backtrace = $exception->getTrace();
  // Add the line throwing the exception to the backtrace.
  array_unshift($backtrace, array('line' => $exception->getLine(), 'file' => $exception->getFile()));

  // For PDOException errors, we try to return the initial caller,
  // skipping internal functions of the database layer.
  if ($exception instanceof PDOException) {
    // The first element in the stack is the call, the second element gives us the caller.
    // We skip calls that occurred in one of the classes of the database layer
    // or in one of its global functions.
    $db_functions = array('db_query', 'db_query_range');
    while (!empty($backtrace[1]) && ($caller = $backtrace[1]) && 
      ((isset($caller['class']) && (strpos($caller['class'], 'Query') !== FALSE || strpos($caller['class'], 'Database') !== FALSE || strpos($caller['class'], 'PDO') !== FALSE)) ||
        in_array($caller['function'], $db_functions))) {
      // We remove that call.
    if (isset($exception->query_string, $exception->args)) {
      $message .= ": " . $exception->query_string . "; " . print_r($exception->args, TRUE);
  $caller = _drupal_get_last_caller($backtrace);

  return array(
    '%type' => get_class($exception),
    // The standard PHP exception handler considers that the exception message
    // is plain-text. We mimick this behavior here.
    '!message' => check_plain($message),
    '%function' => $caller['function'],
    '%file' => $caller['file'],
    '%line' => $caller['line'],
    'severity_level' => WATCHDOG_ERROR,