1 bootstrap.inc | watchdog_exception($type, Exception $exception, $message = NULL, $variables = array(), $severity = WATCHDOG_ERROR, $link = NULL) |
Logs an exception.
This is a wrapper function for watchdog() which automatically decodes an exception.
Parameters
$type: The category to which this message belongs.
$exception: The exception that is going to be logged.
$message: The message to store in the log. If empty, a text that contains all useful information about the passed-in exception is used.
$variables: Array of variables to replace in the message on display. Defaults to the return value of _backdrop_decode_exception().
$severity: The severity of the message, as per RFC 3164.
$link: A link to associate with the message.
See also
watchdog()
File
- core/
includes/ bootstrap.inc, line 2274 - Functions that need to be loaded on every Backdrop request.
Code
function watchdog_exception($type, Exception $exception, $message = NULL, $variables = array(), $severity = WATCHDOG_ERROR, $link = NULL) {
// Return early if not logging this severity level.
if (!watchdog_severity_enabled($severity)) {
return;
}
// Use a default value if $message is not set.
if (empty($message)) {
// The exception message is run through check_plain() by
// _backdrop_decode_exception().
$message = '%type: !message in %function (line %line of %file).';
}
// $variables must be an array so that we can add the exception information.
if (!is_array($variables)) {
$variables = array();
}
require_once BACKDROP_ROOT . '/core/includes/errors.inc';
$variables += _backdrop_decode_exception($exception);
watchdog($type, $message, $variables, $severity, $link);
}