1 <?php
  2 
  3 namespace Psr\Log;
  4 
  5 /**
  6  * This is a simple Logger trait that classes unable to extend AbstractLogger
  7  * (because they extend another class, etc) can include.
  8  *
  9  * It simply delegates all log-level-specific methods to the `log` method to 
 10  * reduce boilerplate code that a simple Logger that does the same thing with 
 11  * messages regardless of the error level has to implement.
 12  */
 13 trait LoggerTrait
 14 {
 15     /**
 16      * System is unusable.
 17      *
 18      * @param string $message
 19      * @param array $context
 20      * @return null
 21      */
 22     public function emergency($message, array $context = array())
 23     {
 24         $this->log(LogLevel::EMERGENCY, $message, $context);
 25     }
 26 
 27     /**
 28      * Action must be taken immediately.
 29      *
 30      * Example: Entire website down, database unavailable, etc. This should
 31      * trigger the SMS alerts and wake you up.
 32      *
 33      * @param string $message
 34      * @param array $context
 35      * @return null
 36      */
 37     public function alert($message, array $context = array())
 38     {
 39         $this->log(LogLevel::ALERT, $message, $context);
 40     }
 41 
 42     /**
 43      * Critical conditions.
 44      *
 45      * Example: Application component unavailable, unexpected exception.
 46      *
 47      * @param string $message
 48      * @param array $context
 49      * @return null
 50      */
 51     public function critical($message, array $context = array())
 52     {
 53         $this->log(LogLevel::CRITICAL, $message, $context);
 54     }
 55 
 56     /**
 57      * Runtime errors that do not require immediate action but should typically
 58      * be logged and monitored.
 59      *
 60      * @param string $message
 61      * @param array $context
 62      * @return null
 63      */
 64     public function error($message, array $context = array())
 65     {
 66         $this->log(LogLevel::ERROR, $message, $context);
 67     }
 68 
 69     /**
 70      * Exceptional occurrences that are not errors.
 71      *
 72      * Example: Use of deprecated APIs, poor use of an API, undesirable things
 73      * that are not necessarily wrong.
 74      *
 75      * @param string $message
 76      * @param array $context
 77      * @return null
 78      */
 79     public function warning($message, array $context = array())
 80     {
 81         $this->log(LogLevel::WARNING, $message, $context);
 82     }
 83 
 84     /**
 85      * Normal but significant events.
 86      *
 87      * @param string $message
 88      * @param array $context
 89      * @return null
 90      */
 91     public function notice($message, array $context = array())
 92     {
 93         $this->log(LogLevel::NOTICE, $message, $context);
 94     }
 95 
 96     /**
 97      * Interesting events.
 98      *
 99      * Example: User logs in, SQL logs.
100      *
101      * @param string $message
102      * @param array $context
103      * @return null
104      */
105     public function info($message, array $context = array())
106     {
107         $this->log(LogLevel::INFO, $message, $context);
108     }
109 
110     /**
111      * Detailed debug information.
112      *
113      * @param string $message
114      * @param array $context
115      * @return null
116      */
117     public function debug($message, array $context = array())
118     {
119         $this->log(LogLevel::DEBUG, $message, $context);
120     }
121 
122     /**
123      * Logs with an arbitrary level.
124      *
125      * @param mixed $level
126      * @param string $message
127      * @param array $context
128      * @return null
129      */
130     abstract public function log($level, $message, array $context = array());
131 }
132