350 lines
9.0 KiB
PHP
350 lines
9.0 KiB
PHP
<?php
|
|
/* Icinga Web 2 | (c) 2014 Icinga Development Team | GPLv2+ */
|
|
|
|
namespace Icinga\Application;
|
|
|
|
use Exception;
|
|
use Icinga\Data\ConfigObject;
|
|
use Icinga\Application\Logger\Writer\FileWriter;
|
|
use Icinga\Application\Logger\Writer\SyslogWriter;
|
|
use Icinga\Exception\ConfigurationError;
|
|
use Icinga\Exception\IcingaException;
|
|
use Icinga\Util\Json;
|
|
|
|
/**
|
|
* Logger
|
|
*/
|
|
class Logger
|
|
{
|
|
/**
|
|
* Debug message
|
|
*/
|
|
const DEBUG = 1;
|
|
|
|
/**
|
|
* Informational message
|
|
*/
|
|
const INFO = 2;
|
|
|
|
/**
|
|
* Warning message
|
|
*/
|
|
const WARNING = 4;
|
|
|
|
/**
|
|
* Error message
|
|
*/
|
|
const ERROR = 8;
|
|
|
|
/**
|
|
* Log levels
|
|
*
|
|
* @var array
|
|
*/
|
|
public static $levels = array(
|
|
Logger::DEBUG => 'DEBUG',
|
|
Logger::INFO => 'INFO',
|
|
Logger::WARNING => 'WARNING',
|
|
Logger::ERROR => 'ERROR'
|
|
);
|
|
|
|
/**
|
|
* This logger's instance
|
|
*
|
|
* @var static
|
|
*/
|
|
protected static $instance;
|
|
|
|
/**
|
|
* Log writer
|
|
*
|
|
* @var \Icinga\Application\Logger\LogWriter
|
|
*/
|
|
protected $writer;
|
|
|
|
/**
|
|
* Maximum level to emit
|
|
*
|
|
* @var int
|
|
*/
|
|
protected $level;
|
|
|
|
/**
|
|
* Error messages to be displayed prior to any other log message
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $configErrors = array();
|
|
|
|
/**
|
|
* Create a new logger object
|
|
*
|
|
* @param ConfigObject $config
|
|
*
|
|
* @throws ConfigurationError If the logging configuration directive 'log' is missing or if the logging level is
|
|
* not defined
|
|
*/
|
|
public function __construct(ConfigObject $config)
|
|
{
|
|
if ($config->log === null) {
|
|
throw new ConfigurationError('Required logging configuration directive \'log\' missing');
|
|
}
|
|
|
|
$this->setLevel($config->get('level', static::ERROR));
|
|
|
|
if (strtolower($config->get('log', 'syslog')) !== 'none') {
|
|
$this->writer = $this->createWriter($config);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set the logging level to use
|
|
*
|
|
* @param mixed $level
|
|
*
|
|
* @return $this
|
|
*
|
|
* @throws ConfigurationError In case the given level is invalid
|
|
*/
|
|
public function setLevel($level)
|
|
{
|
|
if (is_numeric($level)) {
|
|
$level = (int) $level;
|
|
if (! isset(static::$levels[$level])) {
|
|
throw new ConfigurationError(
|
|
'Can\'t set logging level %d. Logging level is invalid. Use one of %s or one of the'
|
|
. ' Logger\'s constants.',
|
|
$level,
|
|
implode(', ', array_keys(static::$levels))
|
|
);
|
|
}
|
|
|
|
$this->level = $level;
|
|
} else {
|
|
$level = strtoupper($level);
|
|
$levels = array_flip(static::$levels);
|
|
if (! isset($levels[$level])) {
|
|
throw new ConfigurationError(
|
|
'Can\'t set logging level "%s". Logging level is invalid. Use one of %s.',
|
|
$level,
|
|
implode(', ', array_keys($levels))
|
|
);
|
|
}
|
|
|
|
$this->level = $levels[$level];
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Return the logging level being used
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getLevel()
|
|
{
|
|
return $this->level;
|
|
}
|
|
|
|
/**
|
|
* Register the given message as config error
|
|
*
|
|
* Config errors are logged every time a log message is being logged.
|
|
*
|
|
* @param mixed $arg,... A string, exception or format-string + substitutions
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function registerConfigError()
|
|
{
|
|
if (func_num_args() > 0) {
|
|
$this->configErrors[] = static::formatMessage(func_get_args());
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Create a new logger object
|
|
*
|
|
* @param ConfigObject $config
|
|
*
|
|
* @return static
|
|
*/
|
|
public static function create(ConfigObject $config)
|
|
{
|
|
static::$instance = new static($config);
|
|
return static::$instance;
|
|
}
|
|
|
|
/**
|
|
* Create a log writer
|
|
*
|
|
* @param ConfigObject $config The configuration to initialize the writer with
|
|
*
|
|
* @return \Icinga\Application\Logger\LogWriter The requested log writer
|
|
* @throws ConfigurationError If the requested writer cannot be found
|
|
*/
|
|
protected function createWriter(ConfigObject $config)
|
|
{
|
|
$class = 'Icinga\\Application\\Logger\\Writer\\' . ucfirst(strtolower($config->log)) . 'Writer';
|
|
if (! class_exists($class)) {
|
|
throw new ConfigurationError(
|
|
'Cannot find log writer of type "%s"',
|
|
$config->log
|
|
);
|
|
}
|
|
return new $class($config);
|
|
}
|
|
|
|
/**
|
|
* Log a message
|
|
*
|
|
* @param int $level The logging level
|
|
* @param string $message The log message
|
|
*/
|
|
public function log($level, $message)
|
|
{
|
|
if ($this->writer !== null && $this->level <= $level) {
|
|
foreach ($this->configErrors as $error_message) {
|
|
$this->writer->log(static::ERROR, $error_message);
|
|
}
|
|
|
|
$this->writer->log($level, $message);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Return a string representation of the passed arguments
|
|
*
|
|
* This method provides three different processing techniques:
|
|
* - If the only passed argument is a string it is returned unchanged
|
|
* - If the only passed argument is an exception it is formatted as follows:
|
|
* <name> in <file>:<line> with message: <message>[ <- <name> ...]
|
|
* - If multiple arguments are passed the first is interpreted as format-string
|
|
* that gets substituted with the remaining ones which can be of any type
|
|
*
|
|
* @param array $arguments The arguments to format
|
|
*
|
|
* @return string The formatted result
|
|
*/
|
|
protected static function formatMessage(array $arguments)
|
|
{
|
|
if (count($arguments) === 1) {
|
|
$message = $arguments[0];
|
|
|
|
if ($message instanceof Exception) {
|
|
$messages = array();
|
|
$error = $message;
|
|
do {
|
|
$messages[] = IcingaException::describe($error);
|
|
} while ($error = $error->getPrevious());
|
|
$message = implode(' <- ', $messages);
|
|
}
|
|
|
|
return $message;
|
|
}
|
|
|
|
return vsprintf(
|
|
array_shift($arguments),
|
|
array_map(
|
|
function ($a) {
|
|
return is_string($a) ? $a : ($a instanceof Exception
|
|
? IcingaException::describe($a)
|
|
: Json::encode($a));
|
|
},
|
|
$arguments
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Log a message with severity ERROR
|
|
*
|
|
* @param mixed $arg,... A string, exception or format-string + substitutions
|
|
*/
|
|
public static function error()
|
|
{
|
|
if (static::$instance !== null && func_num_args() > 0) {
|
|
static::$instance->log(static::ERROR, static::formatMessage(func_get_args()));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Log a message with severity WARNING
|
|
*
|
|
* @param mixed $arg,... A string, exception or format-string + substitutions
|
|
*/
|
|
public static function warning()
|
|
{
|
|
if (static::$instance !== null && func_num_args() > 0) {
|
|
static::$instance->log(static::WARNING, static::formatMessage(func_get_args()));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Log a message with severity INFO
|
|
*
|
|
* @param mixed $arg,... A string, exception or format-string + substitutions
|
|
*/
|
|
public static function info()
|
|
{
|
|
if (static::$instance !== null && func_num_args() > 0) {
|
|
static::$instance->log(static::INFO, static::formatMessage(func_get_args()));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Log a message with severity DEBUG
|
|
*
|
|
* @param mixed $arg,... A string, exception or format-string + substitutions
|
|
*/
|
|
public static function debug()
|
|
{
|
|
if (static::$instance !== null && func_num_args() > 0) {
|
|
static::$instance->log(static::DEBUG, static::formatMessage(func_get_args()));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the log writer to use
|
|
*
|
|
* @return \Icinga\Application\Logger\LogWriter
|
|
*/
|
|
public function getWriter()
|
|
{
|
|
return $this->writer;
|
|
}
|
|
|
|
/**
|
|
* Is the logger writing to Syslog?
|
|
*
|
|
* @return bool
|
|
*/
|
|
public static function writesToSyslog()
|
|
{
|
|
return static::$instance && static::$instance->getWriter() instanceof SyslogWriter;
|
|
}
|
|
|
|
/**
|
|
* Is the logger writing to a file?
|
|
*
|
|
* @return bool
|
|
*/
|
|
public static function writesToFile()
|
|
{
|
|
return static::$instance && static::$instance->getWriter() instanceof FileWriter;
|
|
}
|
|
|
|
/**
|
|
* Get this' instance
|
|
*
|
|
* @return static
|
|
*/
|
|
public static function getInstance()
|
|
{
|
|
return static::$instance;
|
|
}
|
|
}
|