240 lines
8.4 KiB
PHP
240 lines
8.4 KiB
PHP
<?php
|
|
|
|
/*
|
|
* 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.
|
|
*/
|
|
|
|
namespace Monolog;
|
|
|
|
use Psr\Log\LoggerInterface;
|
|
use Psr\Log\LogLevel;
|
|
use Monolog\Handler\AbstractHandler;
|
|
use Monolog\Registry;
|
|
|
|
/**
|
|
* Monolog error handler
|
|
*
|
|
* 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 ErrorHandler
|
|
{
|
|
private $logger;
|
|
|
|
private $previousExceptionHandler;
|
|
private $uncaughtExceptionLevel;
|
|
|
|
private $previousErrorHandler;
|
|
private $errorLevelMap;
|
|
private $handleOnlyReportedErrors;
|
|
|
|
private $hasFatalErrorHandler;
|
|
private $fatalLevel;
|
|
private $reservedMemory;
|
|
private $lastFatalTrace;
|
|
private static $fatalErrors = array(E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR);
|
|
|
|
public function __construct(LoggerInterface $logger)
|
|
{
|
|
$this->logger = $logger;
|
|
}
|
|
|
|
/**
|
|
* Registers a new ErrorHandler for a given Logger
|
|
*
|
|
* By default it will handle errors, exceptions and fatal errors
|
|
*
|
|
* @param 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 ErrorHandler
|
|
*/
|
|
public static function register(LoggerInterface $logger, $errorLevelMap = array(), $exceptionLevel = null, $fatalLevel = null)
|
|
{
|
|
//Forces the autoloader to run for LogLevel. Fixes an autoload issue at compile-time on PHP5.3. See https://github.com/Seldaek/monolog/pull/929
|
|
class_exists('\\Psr\\Log\\LogLevel', true);
|
|
|
|
$handler = new static($logger);
|
|
if ($errorLevelMap !== false) {
|
|
$handler->registerErrorHandler($errorLevelMap);
|
|
}
|
|
if ($exceptionLevel !== false) {
|
|
$handler->registerExceptionHandler($exceptionLevel);
|
|
}
|
|
if ($fatalLevel !== false) {
|
|
$handler->registerFatalHandler($fatalLevel);
|
|
}
|
|
|
|
return $handler;
|
|
}
|
|
|
|
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, $handleOnlyReportedErrors = true)
|
|
{
|
|
$prev = set_error_handler(array($this, 'handleError'), $errorTypes);
|
|
$this->errorLevelMap = array_replace($this->defaultErrorLevelMap(), $levelMap);
|
|
if ($callPrevious) {
|
|
$this->previousErrorHandler = $prev ?: true;
|
|
}
|
|
|
|
$this->handleOnlyReportedErrors = $handleOnlyReportedErrors;
|
|
}
|
|
|
|
public function registerFatalHandler($level = null, $reservedMemorySize = 20)
|
|
{
|
|
register_shutdown_function(array($this, 'handleFatalError'));
|
|
|
|
$this->reservedMemory = str_repeat(' ', 1024 * $reservedMemorySize);
|
|
$this->fatalLevel = $level;
|
|
$this->hasFatalErrorHandler = true;
|
|
}
|
|
|
|
protected function defaultErrorLevelMap()
|
|
{
|
|
return array(
|
|
E_ERROR => LogLevel::CRITICAL,
|
|
E_WARNING => LogLevel::WARNING,
|
|
E_PARSE => LogLevel::ALERT,
|
|
E_NOTICE => LogLevel::NOTICE,
|
|
E_CORE_ERROR => LogLevel::CRITICAL,
|
|
E_CORE_WARNING => LogLevel::WARNING,
|
|
E_COMPILE_ERROR => LogLevel::ALERT,
|
|
E_COMPILE_WARNING => LogLevel::WARNING,
|
|
E_USER_ERROR => LogLevel::ERROR,
|
|
E_USER_WARNING => LogLevel::WARNING,
|
|
E_USER_NOTICE => LogLevel::NOTICE,
|
|
E_STRICT => LogLevel::NOTICE,
|
|
E_RECOVERABLE_ERROR => LogLevel::ERROR,
|
|
E_DEPRECATED => LogLevel::NOTICE,
|
|
E_USER_DEPRECATED => LogLevel::NOTICE,
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @private
|
|
*/
|
|
public function handleException($e)
|
|
{
|
|
$this->logger->log(
|
|
$this->uncaughtExceptionLevel === null ? LogLevel::ERROR : $this->uncaughtExceptionLevel,
|
|
sprintf('Uncaught Exception %s: "%s" at %s line %s', Utils::getClass($e), $e->getMessage(), $e->getFile(), $e->getLine()),
|
|
array('exception' => $e)
|
|
);
|
|
|
|
if ($this->previousExceptionHandler) {
|
|
call_user_func($this->previousExceptionHandler, $e);
|
|
}
|
|
|
|
exit(255);
|
|
}
|
|
|
|
/**
|
|
* @private
|
|
*/
|
|
public function handleError($code, $message, $file = '', $line = 0, $context = array())
|
|
{
|
|
if ($this->handleOnlyReportedErrors && !(error_reporting() & $code)) {
|
|
return;
|
|
}
|
|
|
|
// fatal error codes are ignored if a fatal error handler is present as well to avoid duplicate log entries
|
|
if (!$this->hasFatalErrorHandler || !in_array($code, self::$fatalErrors, true)) {
|
|
$level = isset($this->errorLevelMap[$code]) ? $this->errorLevelMap[$code] : LogLevel::CRITICAL;
|
|
$this->logger->log($level, self::codeToString($code).': '.$message, array('code' => $code, 'message' => $message, 'file' => $file, 'line' => $line));
|
|
} else {
|
|
// http://php.net/manual/en/function.debug-backtrace.php
|
|
// As of 5.3.6, DEBUG_BACKTRACE_IGNORE_ARGS option was added.
|
|
// Any version less than 5.3.6 must use the DEBUG_BACKTRACE_IGNORE_ARGS constant value '2'.
|
|
$trace = debug_backtrace((PHP_VERSION_ID < 50306) ? 2 : DEBUG_BACKTRACE_IGNORE_ARGS);
|
|
array_shift($trace); // Exclude handleError from trace
|
|
$this->lastFatalTrace = $trace;
|
|
}
|
|
|
|
if ($this->previousErrorHandler === true) {
|
|
return false;
|
|
} elseif ($this->previousErrorHandler) {
|
|
return call_user_func($this->previousErrorHandler, $code, $message, $file, $line, $context);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @private
|
|
*/
|
|
public function handleFatalError()
|
|
{
|
|
$this->reservedMemory = null;
|
|
|
|
$lastError = error_get_last();
|
|
if ($lastError && in_array($lastError['type'], self::$fatalErrors, true)) {
|
|
$this->logger->log(
|
|
$this->fatalLevel === null ? 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'], 'trace' => $this->lastFatalTrace)
|
|
);
|
|
|
|
if ($this->logger instanceof Logger) {
|
|
foreach ($this->logger->getHandlers() as $handler) {
|
|
if ($handler instanceof AbstractHandler) {
|
|
$handler->close();
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
private static function codeToString($code)
|
|
{
|
|
switch ($code) {
|
|
case E_ERROR:
|
|
return 'E_ERROR';
|
|
case E_WARNING:
|
|
return 'E_WARNING';
|
|
case E_PARSE:
|
|
return 'E_PARSE';
|
|
case E_NOTICE:
|
|
return 'E_NOTICE';
|
|
case E_CORE_ERROR:
|
|
return 'E_CORE_ERROR';
|
|
case E_CORE_WARNING:
|
|
return 'E_CORE_WARNING';
|
|
case E_COMPILE_ERROR:
|
|
return 'E_COMPILE_ERROR';
|
|
case E_COMPILE_WARNING:
|
|
return 'E_COMPILE_WARNING';
|
|
case E_USER_ERROR:
|
|
return 'E_USER_ERROR';
|
|
case E_USER_WARNING:
|
|
return 'E_USER_WARNING';
|
|
case E_USER_NOTICE:
|
|
return 'E_USER_NOTICE';
|
|
case E_STRICT:
|
|
return 'E_STRICT';
|
|
case E_RECOVERABLE_ERROR:
|
|
return 'E_RECOVERABLE_ERROR';
|
|
case E_DEPRECATED:
|
|
return 'E_DEPRECATED';
|
|
case E_USER_DEPRECATED:
|
|
return 'E_USER_DEPRECATED';
|
|
}
|
|
|
|
return 'Unknown PHP error';
|
|
}
|
|
}
|