Класс 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