Класс ErrorHandler

Обработчик ошибок предоставляет базовые обработку ошибок и исключений для вашего приложения. Он перехватывает и обрабатывает все необработанные исключения и ошибки. Отображает полезные ошибки фреймворка, когда debug > 1.

Неперехваченные исключения

Когда debug < 1, CakeException отобразит ошибки 404 или 500. Если брошено неперехваченное исключение, и оно является типом, который ErrorHandler не знает, оно будет обработано как ошибка 500.

Реализация обработки исключений, специфичных для приложения

Вы можете реализовать обработку исключений, специфичных для приложения, несколькими способами. Каждый подход предоставляет разный уровень контроля над процессом обработки исключений.

• Установите Configure::write('Exception.handler', 'YourClass::yourMethod');
• Создайте AppController::appError();
• Установите Configure::write('Exception.renderer', 'YourClass');

Создание собственного обработчика исключений с Exception.handler

Это предоставляет полный контроль над процессом обработки исключений. Выбранный класс должен быть загружен в вашем файле app/Config/bootstrap.php, чтобы он был доступен для обработки любых исключений. Вы можете определить обработчик как любой тип обратного вызова. Использование Exception.handler переопределяет все другие настройки и логику обработки исключений.

Использование AppController::appError();

Этот метод контроллера вызывается вместо стандартного отображения исключений. Он получает брошенное исключение в качестве единственного аргумента. Вы должны реализовать обработку ошибок в этом методе. Использование AppController::appError() переопределяет любые настройки для Exception.renderer.

Использование пользовательского рендерера с Exception.renderer

Если вы не хотите контролировать обработку исключений, но хотите изменить то, как рендерятся исключения, вы можете использовать Exception.renderer для выбора класса для рендеринга страниц исключений. По умолчанию используется ExceptionRenderer. Ваш пользовательский класс рендерера исключений должен быть размещен в app/Lib/Error.

Ваш пользовательский рендерер должен ожидать исключение в своём конструкторе и реализовать метод render. Отсутствие этого приведёт к дополнительным ошибкам.

Регистрация исключений

Используя встроенную обработку исключений, вы можете регистрировать все исключения, которые обрабатываются ErrorHandler, установив Exception.log в значение true в вашем файле core.php. Включение этого позволит регистрировать каждое исключение в CakeLog и настроенных логгерах.

Ошибки PHP

Обработчик ошибок также предоставляет встроенные возможности для обработки ошибок PHP (trigger_error). В режиме отладки ошибки будут выводиться на экран с помощью отладчика. В режиме производства ошибки будут регистрироваться в CakeLog. Вы можете контролировать, какие ошибки регистрируются, настроив Error.level в вашем файле core.php.

Регистрация ошибок

Когда ErrorHandler используется для обработки ошибок, вы можете включить регистрацию ошибок, установив Error.log в значение true. Это позволит регистрировать все ошибки в настроенных обработчиках логов.

Контроль над тем, какие ошибки регистрируются/отображаются

Вы можете контролировать, какие ошибки регистрируются/отображаются ErrorHandler, настроив Error.level. Установка этого значения в одно или комбинацию нескольких констант E_* позволит включить только указанные ошибки.

Например: Configure::write('Error.level', E_ALL & ~E_NOTICE);

Это включит обработку всех ошибок, кроме Notice.

Краткое описание свойств

• $_bailExceptionRendering protected static
  boolean

  Выполнять ли рендеринг исключения, если сам рендерер бросает исключения.

Краткое описание методов

• _getErrorMessage() protected static
  Генерирует строку для описания ошибки.
• _getMessage() protected static
  Генерирует отформатированное сообщение об ошибке
• _log() protected static
  Обрабатывает регистрацию исключений
• handleError() public static

  Установлен как обработчик ошибок по умолчанию CakePHP. Используйте Configure::write('Error.handler', $callback), чтобы использовать собственные методы обработки ошибок. Эта функция будет использовать Debugger для отображения ошибок, когда debug > 0. И будет регистрировать ошибки в CakeLog, когда debug == 0.

• handleException() public static
  Установлен как обработчик исключений по умолчанию процессом загрузки CakePHP.
• handleFatalError() public static
  Генерирует страницу ошибки при возникновении критической ошибки.
• mapErrorCode() public static
  Преобразует код ошибки в слово «Ошибка» и местоположение для регистрации.

Подробное описание методов

_getErrorMessage( string $error , integer $code , string $description , string $file , integer $line )

_getMessage( Exception $exception )

_log( Exception|ParseError $exception , array $config )

handleError( integer $code , string $description , string $file null , integer $line null , array $context null )

handleException( Exception|ParseError $exception )

handleFatalError( integer $code , string $description , string $file , integer $line )

mapErrorCode( integer $code )

Подробности свойств

false