class ExceptionLoggingSubscriber in Drupal 8

Log exceptions without further handling.

Hierarchy

• class \Drupal\Core\EventSubscriber\ExceptionLoggingSubscriber implements \Symfony\Component\EventDispatcher\EventSubscriberInterface

1 string reference to 'ExceptionLoggingSubscriber'

core.services.yml in core/core.services.yml

core/core.services.yml

1 service uses ExceptionLoggingSubscriber

exception.logger in core/core.services.yml

Drupal\Core\EventSubscriber\ExceptionLoggingSubscriber

File

core/lib/Drupal/Core/EventSubscriber/ExceptionLoggingSubscriber.php, line 15

Namespace

Drupal\Core\EventSubscriber

class ExceptionLoggingSubscriber implements EventSubscriberInterface {

  /**
   * The logger channel factory.
   *
   * @var \Drupal\Core\Logger\LoggerChannelFactoryInterface
   */
  protected $logger;

  /**
   * Constructs a new ExceptionLoggingSubscriber.
   *
   * @param \Drupal\Core\Logger\LoggerChannelFactoryInterface $logger
   *   The logger channel factory.
   */
  public function __construct(LoggerChannelFactoryInterface $logger) {
    $this->logger = $logger;
  }

  /**
   * Log 403 errors.
   *
   * @param \Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent $event
   *   The event to process.
   */
  public function on403(GetResponseForExceptionEvent $event) {

    // Log the exception with the page where it happened so that admins know
    // why access was denied.
    $exception = $event
      ->getException();
    $error = Error::decodeException($exception);
    unset($error['@backtrace_string']);
    $error['@uri'] = $event
      ->getRequest()
      ->getRequestUri();
    $this->logger
      ->get('access denied')
      ->warning('Path: @uri. %type: @message in %function (line %line of %file).', $error);
  }

  /**
   * Log 404 errors.
   *
   * @param \Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent $event
   *   The event to process.
   */
  public function on404(GetResponseForExceptionEvent $event) {
    $request = $event
      ->getRequest();
    $this->logger
      ->get('page not found')
      ->warning('@uri', [
      '@uri' => $request
        ->getRequestUri(),
    ]);
  }

  /**
   * Log not-otherwise-specified errors, including HTTP 500.
   *
   * @param \Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent $event
   *   The event to process.
   */
  public function onError(GetResponseForExceptionEvent $event) {
    $exception = $event
      ->getException();
    $error = Error::decodeException($exception);
    $this->logger
      ->get('php')
      ->log($error['severity_level'], '%type: @message in %function (line %line of %file).', $error);
    $is_critical = !$exception instanceof HttpExceptionInterface || $exception
      ->getStatusCode() >= 500;
    if ($is_critical) {
      error_log(sprintf('Uncaught PHP Exception %s: "%s" at %s line %s', get_class($exception), $exception
        ->getMessage(), $exception
        ->getFile(), $exception
        ->getLine()));
    }
  }

  /**
   * Log all exceptions.
   *
   * @param \Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent $event
   *   The event to process.
   */
  public function onException(GetResponseForExceptionEvent $event) {
    $exception = $event
      ->getException();
    $method = 'onError';

    // Treat any non-HTTP exception as if it were one, so we log it the same.
    if ($exception instanceof HttpExceptionInterface) {
      $possible_method = 'on' . $exception
        ->getStatusCode();
      if (method_exists($this, $possible_method)) {
        $method = $possible_method;
      }
    }
    $this
      ->{$method}($event);
  }

  /**
   * {@inheritdoc}
   */
  public static function getSubscribedEvents() {
    $events[KernelEvents::EXCEPTION][] = [
      'onException',
      50,
    ];
    return $events;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
ExceptionLoggingSubscriber::$logger	protected	property	The logger channel factory.
ExceptionLoggingSubscriber::getSubscribedEvents	public static	function	Returns an array of event names this subscriber wants to listen to.
ExceptionLoggingSubscriber::on403	public	function	Log 403 errors.
ExceptionLoggingSubscriber::on404	public	function	Log 404 errors.
ExceptionLoggingSubscriber::onError	public	function	Log not-otherwise-specified errors, including HTTP 500.
ExceptionLoggingSubscriber::onException	public	function	Log all exceptions.
ExceptionLoggingSubscriber::__construct	public	function	Constructs a new ExceptionLoggingSubscriber.