FinalExceptionSubscriber
class FinalExceptionSubscriber implements EventSubscriberInterface (View source)
Last-chance handler for exceptions: the final exception subscriber.
This handler will catch any exceptions not caught elsewhere and report them as an error page.
Each format has its own way of handling exceptions:
- html: exception.default_html, exception.custom_page_html and exception.fast_404_html
- json: exception.default_json
And when the serialization module is installed, all serialization formats are handled by a single exception subscriber:: serialization.exception.default.
This exception subscriber runs after all the above (it has a lower priority), which makes it the last-chance exception handler. It always sends a plain text response. If it's a displayable error and the error level is configured to be verbose, then a helpful backtrace is also printed.
Traits
Wrapper methods for \Drupal\Core\StringTranslation\TranslationInterface.
Properties
| protected TranslationInterface | $stringTranslation | The string translation service. |
from StringTranslationTrait |
| protected string | $errorLevel | ||
| protected ConfigFactoryInterface | $configFactory | The config factory. |
Methods
Translates a string to the current language or to a given language.
Formats a string containing a count of items.
Returns the number of plurals supported by a given language.
Gets the string translation service.
Gets the configured error level.
Handles exceptions for this subscriber.
{@inheritdoc}
Checks whether the error level is verbose or not.
Wrapper for error_displayable().
Attempts to reduce error verbosity in the error message's file path.
Details
protected TranslatableMarkup
t(string $string, array $args = [], array $options = [])
Translates a string to the current language or to a given language.
See \Drupal\Core\StringTranslation\TranslatableMarkup::__construct() for important security information and usage guidelines.
In order for strings to be localized, make them available in one of the ways supported by the
protected
formatPlural($count, $singular, $plural, array $args = [], array $options = [])
Formats a string containing a count of items.
protected
getNumberOfPlurals($langcode = NULL)
Returns the number of plurals supported by a given language.
protected TranslationInterface
getStringTranslation()
Gets the string translation service.
$this
setStringTranslation(TranslationInterface $translation)
Sets the string translation service to use.
__construct(ConfigFactoryInterface $config_factory)
Constructs a new FinalExceptionSubscriber.
protected string
getErrorLevel()
Gets the configured error level.
onException(ExceptionEvent $event)
Handles exceptions for this subscriber.
static
getSubscribedEvents()
{@inheritdoc}
protected bool
isErrorLevelVerbose()
Checks whether the error level is verbose or not.
protected bool
isErrorDisplayable($error)
Wrapper for error_displayable().
protected The
simplifyFileInError($error)
Attempts to reduce error verbosity in the error message's file path.
Attempts to reduce verbosity by removing DRUPAL_ROOT from the file path in the message. This does not happen for (false) security.