* 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.
* It contains a stack of Handlers and a stack of Processors,
* and uses them to store records that are added to it.
* @author Jordi Boggiano <j.boggiano@seld.be>
class Monolog_Logger implements Monolog_Psr_LoggerInterface
* Detailed debug information
* Examples: User logs in, SQL logs.
* Exceptional occurrences that are not errors
* Examples: Use of deprecated APIs, poor use of an API,
* undesirable things that are not necessarily wrong.
* Example: Application component unavailable, unexpected exception.
* Action must be taken immediately
* Example: Entire website down, database unavailable, etc.
* This should trigger the SMS alerts and wake you up.
* This is only bumped when API breaks are done and should
* follow the major version of the library
* Logging levels from syslog protocol defined in RFC 5424
* @var array $levels Logging levels
protected static $levels = array(
protected static $timezone;
* @var Monolog_Handler_HandlerInterface[]
* Processors that will process all log records
* To process records of a single handler instead, add the processor on that specific handler
* @param string $name The logging channel
* @param Monolog_Handler_HandlerInterface[] $handlers Optional stack of handlers, the first one in the array is called first, etc.
* @param callable[] $processors Optional array of processors
public function __construct($name, array $handlers = array(), array $processors = array())
$this->handlers = $handlers;
$this->processors = $processors;
public function getName()
* Pushes a handler on to the stack.
* @param Monolog_Handler_HandlerInterface $handler
public function pushHandler(Monolog_Handler_HandlerInterface $handler)
array_unshift($this->handlers, $handler);
* Pops a handler from the stack
* @return Monolog_Handler_HandlerInterface
public function popHandler()
throw new LogicException('You tried to pop from an empty handler stack.');
return array_shift($this->handlers);
* Adds a processor on to the stack.
* @param callable $callback
public function pushProcessor($callback)
if (!is_callable($callback)) {
throw new InvalidArgumentException('Processors must be valid callables (callback or object with an __invoke method), '.var_export($callback, true).' given');
array_unshift($this->processors, $callback);
* Removes the processor on top of the stack and returns it.
public function popProcessor()
if (!$this->processors) {
throw new LogicException('You tried to pop from an empty processor stack.');
return array_shift($this->processors);
* @param integer $level The logging level
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function addRecord($level, $message, array $context = array())
$this->pushHandler(new Monolog_Handler_StreamHandler('php://stderr', self::DEBUG));
'message' => (string) $message,
'level_name' => self::getLevelName($level),
'channel' => $this->name,
'datetime' => $this->getCurrentTimestamp(),
// check if any handler will handle this message
foreach ($this->handlers as $key => $handler) {
if ($handler->isHandling($record)) {
if (null === $handlerKey) {
// found at least one, process message and dispatch it
foreach ($this->processors as $processor) {
$record = call_user_func($processor, $record);
while (isset($this->handlers[$handlerKey]) &&
false === $this->handlers[$handlerKey]->handle($record)) {
private function getCurrentTimestamp()
self::$timezone = new DateTimeZone(date_default_timezone_get() ? date_default_timezone_get() : 'UTC');
if (is_callable(array('DateTime', 'createFromFormat'))) {
return DateTime::createFromFormat('U.u', sprintf('%.6F', microtime(true)), self::$timezone)->setTimezone(self::$timezone);
return new DateTime('now', self::$timezone);
* Adds a log record at the DEBUG level.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function addDebug($message, array $context = array())
return $this->addRecord(self::DEBUG, $message, $context);
* Adds a log record at the INFO level.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function addInfo($message, array $context = array())
return $this->addRecord(self::INFO, $message, $context);
* Adds a log record at the NOTICE level.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function addNotice($message, array $context = array())
return $this->addRecord(self::NOTICE, $message, $context);
* Adds a log record at the WARNING level.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function addWarning($message, array $context = array())
return $this->addRecord(self::WARNING, $message, $context);
* Adds a log record at the ERROR level.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function addError($message, array $context = array())
return $this->addRecord(self::ERROR, $message, $context);
* Adds a log record at the CRITICAL level.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function addCritical($message, array $context = array())
return $this->addRecord(self::CRITICAL, $message, $context);
* Adds a log record at the ALERT level.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function addAlert($message, array $context = array())
return $this->addRecord(self::ALERT, $message, $context);
* Adds a log record at the EMERGENCY level.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function addEmergency($message, array $context = array())
return $this->addRecord(self::EMERGENCY, $message, $context);
* Gets all supported logging levels.
* @return array Assoc array with human-readable level names => level codes.
public static function getLevels()
return array_flip(self::$levels);
* Gets the name of the logging level.
public static function getLevelName($level)
if (!isset(self::$levels[$level])) {
throw new InvalidArgumentException('Level "'.$level.'" is not defined, use one of: '.implode(', ', array_keys(self::$levels)));
return self::$levels[$level];
* Checks whether the Logger has a handler that listens on the given level
public function isHandling($level)
foreach ($this->handlers as $handler) {
if ($handler->isHandling($record)) {
* Adds a log record at an arbitrary level.
* This method allows for compatibility with common interfaces.
* @param mixed $level The log level
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function log($level, $message, array $context = array())
if (is_string($level) && defined(__CLASS__.'::'.strtoupper($level))) {
$level = constant(__CLASS__.'::'.strtoupper($level));
return $this->addRecord($level, $message, $context);
* Adds a log record at the DEBUG level.
* This method allows for compatibility with common interfaces.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function debug($message, array $context = array())
return $this->addRecord(self::DEBUG, $message, $context);
* Adds a log record at the INFO level.
* This method allows for compatibility with common interfaces.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function info($message, array $context = array())
return $this->addRecord(self::INFO, $message, $context);
* Adds a log record at the INFO level.
* This method allows for compatibility with common interfaces.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function notice($message, array $context = array())
return $this->addRecord(self::NOTICE, $message, $context);
* Adds a log record at the WARNING level.
* This method allows for compatibility with common interfaces.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function warn($message, array $context = array())
return $this->addRecord(self::WARNING, $message, $context);
* Adds a log record at the WARNING level.
* This method allows for compatibility with common interfaces.
* @param string $message The log message
* @param array $context The log context
* @return Boolean Whether the record has been processed
public function warning($message, array $context = array())
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
