2
0
Jordi Boggiano 13 жил өмнө
parent
commit
c8ca42764c
2 өөрчлөгдсөн 25 нэмэгдсэн , 26 устгасан
  1. 13 11
      README.mdown
  2. 12 15
      src/Monolog/Logger.php

+ 13 - 11
README.mdown

@@ -47,24 +47,26 @@ will be created if you don't set one. The formatters normalize and format
 incoming records so that they can be used by the handlers to output useful
 information.
 
-Custom severity levels are not available. Only the eight RFC 5424 levels (debug, 
-info, notice, warning, error, critical, alert, emergency) are present for basic 
-filtering purposes, but for sorting and other use cases that would require 
-flexibility, you should add Processors to the Logger that can add extra 
+Custom severity levels are not available. Only the eight
+[RFC 5424](http://tools.ietf.org/html/rfc5424) levels (debug, info, notice,
+warning, error, critical, alert, emergency) are present for basic filtering
+purposes, but for sorting and other use cases that would require
+flexibility, you should add Processors to the Logger that can add extra
 information (tags, user ip, ..) to the records before they are handled.
 
 Log Levels
 ----------
 
-Monolog supports all 8 logging levels defined in RFC5424, but unless you 
-specifically need syslog compatibility, it is advised to only use DEBUG, INFO, 
-WARNING, ERROR, CRITICAL, ALERT.
+Monolog supports all 8 logging levels defined in
+[RFC 5424](http://tools.ietf.org/html/rfc5424), but unless you specifically
+need syslog compatibility, it is advised to only use DEBUG, INFO, WARNING,
+ERROR, CRITICAL, ALERT.
 
 - **DEBUG** (100): Detailed debug information.
 
 - **INFO** (200): Interesting events. Examples: User logs in, SQL logs.
 
-- **NOTICE** (250): Normal but significant events.
+- NOTICE (250): Normal but significant events.
 
 - **WARNING** (300): Exceptional occurrences that are not errors. Examples:
   Use of deprecated APIs, poor use of an API, undesirable things that are not
@@ -80,12 +82,12 @@ WARNING, ERROR, CRITICAL, ALERT.
   down, database unavailable, etc. This should trigger the SMS alerts and wake
   you up.
 
-- **EMERGENCY** (600): Emergency: system is unusable.
+- EMERGENCY (600): Emergency: system is unusable.
 
 Docs
 ====
 
-**See the `doc` directory for more detailed documentation. 
+**See the `doc` directory for more detailed documentation.
 The following is only a list of all parts that come with Monolog.**
 
 Handlers
@@ -102,7 +104,7 @@ Handlers
   inline `console` messages within Chrome.
 - _MongoDBHandler_: Handler to write records in MongoDB via a
   [Mongo](http://pecl.php.net/package/mongo) extension connection.
-- _NativeMailHandler_: Sends emails using PHP's 
+- _NativeMailHandler_: Sends emails using PHP's
   [`mail()`](http://php.net/manual/en/function.mail.php) function.
 - _SwiftMailerHandler_: Sends emails using a `Swift_Mailer` instance.
 - _SyslogHandler_: Logs records to the syslog.

+ 12 - 15
src/Monolog/Logger.php

@@ -236,8 +236,8 @@ class Logger
     /**
      * Adds a log record at the NOTICE level.
      *
-     * @param string $message The log message
-     * @param array $context The log context
+     * @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())
@@ -296,8 +296,8 @@ class Logger
     /**
      * Adds a log record at the EMERGENCY level.
      *
-     * @param string $message The log message
-     * @param array $context The log context
+     * @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())
@@ -305,7 +305,6 @@ class Logger
       return $this->addRecord(self::EMERGENCY, $message, $context);
     }
 
-
     /**
      * Gets the name of the logging level.
      *
@@ -344,12 +343,10 @@ class Logger
         return false;
     }
 
-    // ZF Logger Compat
-
     /**
      * Adds a log record at the DEBUG level.
      *
-     * This method allows to have an easy ZF/Symfony 2 compatibility.
+     * This method allows for compatibility with common interfaces.
      *
      * @param  string  $message The log message
      * @param  array   $context The log context
@@ -363,7 +360,7 @@ class Logger
     /**
      * Adds a log record at the INFO level.
      *
-     * This method allows to have an easy ZF/Symfony 2 compatibility.
+     * This method allows for compatibility with common interfaces.
      *
      * @param  string  $message The log message
      * @param  array   $context The log context
@@ -377,7 +374,7 @@ class Logger
     /**
      * Adds a log record at the INFO level.
      *
-     * This method allows to have an easy ZF/Symfony 2 compatibility.
+     * This method allows for compatibility with common interfaces.
      *
      * @param  string  $message The log message
      * @param  array   $context The log context
@@ -391,7 +388,7 @@ class Logger
     /**
      * Adds a log record at the WARNING level.
      *
-     * This method allows to have an easy ZF/Symfony 2 compatibility.
+     * This method allows for compatibility with common interfaces.
      *
      * @param  string  $message The log message
      * @param  array   $context The log context
@@ -405,7 +402,7 @@ class Logger
     /**
      * Adds a log record at the ERROR level.
      *
-     * This method allows to have an easy ZF/Symfony 2 compatibility.
+     * This method allows for compatibility with common interfaces.
      *
      * @param  string  $message The log message
      * @param  array   $context The log context
@@ -419,7 +416,7 @@ class Logger
     /**
      * Adds a log record at the CRITICAL level.
      *
-     * This method allows to have an easy ZF/Symfony 2 compatibility.
+     * This method allows for compatibility with common interfaces.
      *
      * @param  string  $message The log message
      * @param  array   $context The log context
@@ -433,7 +430,7 @@ class Logger
     /**
      * Adds a log record at the ALERT level.
      *
-     * This method allows to have an easy ZF/Symfony 2 compatibility.
+     * This method allows for compatibility with common interfaces.
      *
      * @param  string  $message The log message
      * @param  array   $context The log context
@@ -447,7 +444,7 @@ class Logger
     /**
      * Adds a log record at the EMERGENCY level.
      *
-     * This method allows to have an easy ZF/Symfony 2 compatibility.
+     * This method allows for compatibility with common interfaces.
      *
      * @param  string  $message The log message
      * @param  array   $context The log context