* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog; use Monolog\Handler\HandlerInterface; use Monolog\Handler\StreamHandler; /** * Monolog log channel * * 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 */ class Logger { /** * Debug messages */ const DEBUG = 100; /** * Messages you usually don't want to see */ const INFO = 200; /** * Exceptional occurences that are not errors * * This is typically the logging level you want to use */ const WARNING = 300; /** * Errors */ const ERROR = 400; protected static $levels = array( 100 => 'DEBUG', 200 => 'INFO', 300 => 'WARNING', 400 => 'ERROR', ); protected $name; /** * The handler stack * * @var array of Monolog\Handler\HandlerInterface */ protected $handlers = array(); protected $processors = array(); /** * @param string $name The logging channel */ public function __construct($name) { $this->name = $name; } /** * Pushes an handler on the stack. * * @param HandlerInterface $handler */ public function pushHandler(HandlerInterface $handler) { array_unshift($this->handlers, $handler); } /** * Pops an handler from the stack * * @return HandlerInterface */ public function popHandler() { if (!$this->handlers) { throw new \LogicException('You tried to pop from an empty handler stack.'); } return array_shift($this->handlers); } /** * Adds a processor in the stack. * * @param callable $callback */ public function pushProcessor($callback) { array_unshift($this->processors, $callback); } /** * Removes the processor on top of the stack and returns it. * * @return callable */ public function popProcessor() { if (!$this->processors) { throw new \LogicException('You tried to pop from an empty processor stack.'); } return array_shift($this->processors); } /** * Adds a log record. * * @param integer $level The logging level * @param string $message The log message * @return Boolean Whether the record has been processed */ public function addRecord($level, $message) { if (!$this->handlers) { $this->pushHandler(new StreamHandler('php://stderr', self::DEBUG)); } $record = array( 'message' => $message, 'level' => $level, 'level_name' => self::getLevelName($level), 'channel' => $this->name, 'datetime' => new \DateTime(), 'extra' => array(), ); // check if any message will handle this message $handlerKey = null; foreach ($this->handlers as $key => $handler) { if ($handler->isHandling($record)) { $handlerKey = $key; break; } } // none found if (null === $handlerKey) { return false; } // found at least one, process message and dispatch it foreach ($this->processors as $processor) { $record = call_user_func($processor, $record, $this); } while (isset($this->handlers[$handlerKey]) && false === $this->handlers[$handlerKey]->handle($record)) { $handlerKey++; } return true; } /** * Adds a log record at the DEBUG level. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function addDebug($message) { return $this->addRecord(self::DEBUG, $message); } /** * Adds a log record at the INFO level. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function addInfo($message) { return $this->addRecord(self::INFO, $message); } /** * Adds a log record at the WARNING level. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function addWarning($message) { return $this->addRecord(self::WARNING, $message); } /** * Adds a log record at the ERROR level. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function addError($message) { return $this->addRecord(self::ERROR, $message); } /** * Gets the name of the logging level. * * @param integer $level * @return string */ public static function getLevelName($level) { return self::$levels[$level]; } // ZF Logger Compat /** * Adds a log record at the DEBUG level. * * This method allows to have an esay ZF compatibility. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function debug($message) { return $this->addRecord(self::DEBUG, $message); } /** * Adds a log record at the INFO level. * * This method allows to have an esay ZF compatibility. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function info($message) { return $this->addRecord(self::INFO, $message); } /** * Adds a log record at the INFO level. * * This method allows to have an esay ZF compatibility. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function notice($message) { return $this->addRecord(self::INFO, $message); } /** * Adds a log record at the WARNING level. * * This method allows to have an esay ZF compatibility. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function warn($message) { return $this->addRecord(self::WARNING, $message); } /** * Adds a log record at the ERROR level. * * This method allows to have an esay ZF compatibility. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function err($message) { return $this->addRecord(self::ERROR, $message); } /** * Adds a log record at the ERROR level. * * This method allows to have an esay ZF compatibility. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function crit($message) { return $this->addRecord(self::ERROR, $message); } /** * Adds a log record at the ERROR level. * * This method allows to have an esay ZF compatibility. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function alert($message) { return $this->addRecord(self::ERROR, $message); } /** * Adds a log record at the ERROR level. * * This method allows to have an esay ZF compatibility. * * @param string $message The log message * @return Boolean Whether the record has been processed */ public function emerg($message) { return $this->addRecord(self::ERROR, $message); } }