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

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

_getMessage( Exception $exception )

_log( Exception $exception , array $config )

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

handleException( Exception $exception )

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

mapErrorCode( integer $code )

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

false