Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\Core\Logger;
Chris@0: 
Chris@0: use Drupal\Core\StringTranslation\TranslatableMarkup;
Chris@0: 
Chris@0: /**
Chris@0:  * @defgroup logging_severity_levels Logging severity levels
Chris@0:  * @{
Chris@0:  * Logging severity levels as defined in RFC 5424.
Chris@0:  *
Chris@0:  * The constant definitions of this class correspond to the logging severity
Chris@0:  * levels defined in RFC 5424, section 4.1.1. PHP supplies predefined LOG_*
Chris@0:  * constants for use in the syslog() function, but their values on Windows
Chris@0:  * builds do not correspond to RFC 5424. The associated PHP bug report was
Chris@0:  * closed with the comment, "And it's also not a bug, as Windows just have less
Chris@0:  * log levels," and "So the behavior you're seeing is perfectly normal."
Chris@0:  *
Chris@0:  * @see http://tools.ietf.org/html/rfc5424
Chris@0:  * @see http://bugs.php.net/bug.php?id=18090
Chris@0:  * @see http://php.net/manual/function.syslog.php
Chris@0:  * @see http://php.net/manual/network.constants.php
Chris@17:  * @see \Drupal\Core\Logger\RfcLogLevel::getLevels()
Chris@0:  *
Chris@17:  * @}
Chris@0:  */
Chris@0: 
Chris@0: /**
Chris@0:  * Defines various logging severity levels.
Chris@0:  *
Chris@0:  * @ingroup logging_severity_levels
Chris@0:  */
Chris@0: class RfcLogLevel {
Chris@0: 
Chris@0:   /**
Chris@0:    * Log message severity -- Emergency: system is unusable.
Chris@0:    */
Chris@0:   const EMERGENCY = 0;
Chris@0: 
Chris@0:   /**
Chris@0:    * Log message severity -- Alert: action must be taken immediately.
Chris@0:    */
Chris@0:   const ALERT = 1;
Chris@0: 
Chris@0:   /**
Chris@0:    * Log message severity -- Critical conditions.
Chris@0:    */
Chris@0:   const CRITICAL = 2;
Chris@0: 
Chris@0:   /**
Chris@0:    * Log message severity -- Error conditions.
Chris@0:    */
Chris@0:   const ERROR = 3;
Chris@0: 
Chris@0:   /**
Chris@0:    * Log message severity -- Warning conditions.
Chris@0:    */
Chris@0:   const WARNING = 4;
Chris@0: 
Chris@0:   /**
Chris@0:    * Log message severity -- Normal but significant conditions.
Chris@0:    */
Chris@0:   const NOTICE = 5;
Chris@0: 
Chris@0:   /**
Chris@0:    * Log message severity -- Informational messages.
Chris@0:    */
Chris@0:   const INFO = 6;
Chris@0: 
Chris@0:   /**
Chris@0:    * Log message severity -- Debug-level messages.
Chris@0:    */
Chris@0:   const DEBUG = 7;
Chris@0: 
Chris@0:   /**
Chris@0:    * An array with the severity levels as keys and labels as values.
Chris@0:    *
Chris@0:    * @var array
Chris@0:    */
Chris@0:   protected static $levels;
Chris@0: 
Chris@0:   /**
Chris@0:    * Returns a list of severity levels, as defined in RFC 5424.
Chris@0:    *
Chris@0:    * @return array
Chris@0:    *   Array of the possible severity levels for log messages.
Chris@0:    *
Chris@0:    * @see http://tools.ietf.org/html/rfc5424
Chris@0:    * @ingroup logging_severity_levels
Chris@0:    */
Chris@0:   public static function getLevels() {
Chris@0:     if (!static::$levels) {
Chris@0:       static::$levels = [
Chris@0:         static::EMERGENCY => new TranslatableMarkup('Emergency'),
Chris@0:         static::ALERT => new TranslatableMarkup('Alert'),
Chris@0:         static::CRITICAL => new TranslatableMarkup('Critical'),
Chris@0:         static::ERROR => new TranslatableMarkup('Error'),
Chris@0:         static::WARNING => new TranslatableMarkup('Warning'),
Chris@0:         static::NOTICE => new TranslatableMarkup('Notice'),
Chris@0:         static::INFO => new TranslatableMarkup('Info'),
Chris@0:         static::DEBUG => new TranslatableMarkup('Debug'),
Chris@0:       ];
Chris@0:     }
Chris@0: 
Chris@0:     return static::$levels;
Chris@0:   }
Chris@0: 
Chris@0: }