* This file is part of the Monolog package.
* (c) Jordi Boggiano <j.boggiano@seld.be>
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
* A facility to enable logging of runtime errors, exceptions and fatal errors.
* Quick setup: <code>ErrorHandler::register($logger);</code>
* @author Jordi Boggiano <j.boggiano@seld.be>
class Monolog_ErrorHandler
private $previousExceptionHandler;
private $uncaughtExceptionLevel;
private $previousErrorHandler;
private static $fatalErrors = array(E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR);
public function __construct(Monolog_Psr_LoggerInterface $logger)
* Registers a new ErrorHandler for a given Logger
* By default it will handle errors, exceptions and fatal errors
* @param Monolog_Psr_LoggerInterface $logger
* @param array|false $errorLevelMap an array of E_* constant to LogLevel::* constant mapping, or false to disable error handling
* @param int|false $exceptionLevel a LogLevel::* constant, or false to disable exception handling
* @param int|false $fatalLevel a LogLevel::* constant, or false to disable fatal error handling
* @return Monolog_ErrorHandler
public static function register(Monolog_Psr_LoggerInterface $logger, $errorLevelMap = array(), $exceptionLevel = null, $fatalLevel = null)
$handler = new self($logger);
if ($errorLevelMap !== false) {
$handler->registerErrorHandler($errorLevelMap);
if ($exceptionLevel !== false) {
$handler->registerExceptionHandler($exceptionLevel);
if ($fatalLevel !== false) {
$handler->registerFatalHandler($fatalLevel);
public function registerExceptionHandler($level = null, $callPrevious = true)
$prev = set_exception_handler(array($this, 'handleException'));
$this->uncaughtExceptionLevel = $level;
if ($callPrevious && $prev) {
$this->previousExceptionHandler = $prev;
public function registerErrorHandler(array $levelMap = array(), $callPrevious = true, $errorTypes = -1)
$prev = set_error_handler(array($this, 'handleError'), $errorTypes);
$this->errorLevelMap = $this->arrayReplace($this->defaultErrorLevelMap(), $levelMap);
$this->previousErrorHandler = $prev ? $prev : true;
* Backport of PHP >=5.3 function array_replace
* @link http://www.php.net/manual/en/function.array-replace.php#94458
private function arrayReplace(array $array, array $array1)
$count = func_num_args();
for ($i = 0; $i < $count; ++$i) {
if (is_array($args[$i])) {
foreach ($args[$i] as $key => $val) {
__FUNCTION__.'(): Argument #'.($i + 1).' is not an array',
public function registerFatalHandler($level = null, $reservedMemorySize = 20)
register_shutdown_function(array($this, 'handleFatalError'));
$this->reservedMemory = str_repeat(' ', 1024 * $reservedMemorySize);
$this->fatalLevel = $level;
protected function defaultErrorLevelMap()
E_ERROR => Monolog_Psr_LogLevel::CRITICAL,
E_WARNING => Monolog_Psr_LogLevel::WARNING,
E_PARSE => Monolog_Psr_LogLevel::ALERT,
E_NOTICE => Monolog_Psr_LogLevel::NOTICE,
E_CORE_ERROR => Monolog_Psr_LogLevel::CRITICAL,
E_CORE_WARNING => Monolog_Psr_LogLevel::WARNING,
E_COMPILE_ERROR => Monolog_Psr_LogLevel::ALERT,
E_COMPILE_WARNING => Monolog_Psr_LogLevel::WARNING,
E_USER_ERROR => Monolog_Psr_LogLevel::ERROR,
E_USER_WARNING => Monolog_Psr_LogLevel::WARNING,
E_USER_NOTICE => Monolog_Psr_LogLevel::NOTICE,
E_STRICT => Monolog_Psr_LogLevel::NOTICE,
E_RECOVERABLE_ERROR => Monolog_Psr_LogLevel::ERROR,
if (version_compare(PHP_VERSION, '5.3', '>=')) {
$map[E_USER_DEPRECATED] = Monolog_Psr_LogLevel::NOTICE;
$map[E_DEPRECATED] = Monolog_Psr_LogLevel::NOTICE;
public function handleException($e)
$this->uncaughtExceptionLevel === null ? Monolog_Psr_LogLevel::ERROR : $this->uncaughtExceptionLevel,
if ($this->previousExceptionHandler) {
call_user_func($this->previousExceptionHandler, $e);
public function handleError($code, $message, $file = '', $line = 0, $context = array())
if (!(error_reporting() & $code)) {
$level = isset($this->errorLevelMap[$code]) ? $this->errorLevelMap[$code] : Monolog_Psr_LogLevel::CRITICAL;
$this->logger->log($level, self::codeToString($code).': '.$message, array('code' => $code, 'message' => $message, 'file' => $file, 'line' => $line));
if ($this->previousErrorHandler === true) {
} elseif ($this->previousErrorHandler) {
return call_user_func($this->previousErrorHandler, $code, $message, $file, $line, $context);
public function handleFatalError()
$this->reservedMemory = null;
$lastError = error_get_last();
if ($lastError && in_array($lastError['type'], self::$fatalErrors)) {
$this->fatalLevel === null ? Monolog_Psr_LogLevel::ALERT : $this->fatalLevel,
'Fatal Error ('.self::codeToString($lastError['type']).'): '.$lastError['message'],
array('code' => $lastError['type'], 'message' => $lastError['message'], 'file' => $lastError['file'], 'line' => $lastError['line'])
private static function codeToString($code)
return 'E_COMPILE_ERROR';
return 'E_COMPILE_WARNING';
case E_RECOVERABLE_ERROR:
return 'E_RECOVERABLE_ERROR';
return 'E_USER_DEPRECATED';
if (version_compare(PHP_VERSION, '5.3', '>=')) {
return 'E_USER_DEPRECATED';
return 'Unknown PHP error';