= sfAdvancedLogger plug-in =

The `sfAdvancedLogger` provide advanced logging functionality :
  * log PHP errors
  * log uncaught exceptions
  * conditional logging
  * email alerts


== Installation ==

  * Install the plug-in
  
    {{{
      symfony plugin-install http://plugins.symfony-project.com/sfAdvancedLoggerPlugin
    }}}

  * Enable the logger in your `logging.yml`

    {{{
  all:
    loggers:
      sf_advanced_logger:
         class: sfAdvancedLogger
         param:
           php_level: 4095 # E_ALL | E_STRIC
           exception: on # log uncaught exceptions
           email:
             - level: 0 # SF_LOG_EMERG
               to: alertes@domain.net
               subject: Only emerg errors
             - min_level: 5 # SF_LOG_NOTICE and up
               to: dev@domain.net
               subject: From notice to emerg errors
             - type: [PHP, Exception] # Only PHP and uncaught exception
               to: default@domain.net
               subject: errors on PHP errors and uncaught exceptions
             - no_type: [PHP] # none of PHP errors
               to: default@domain.net
               subject: errors that aren&#039;t PHP errors
             - min_level: 5 # SF_LOG_NOTICE and up
               type: sfView
               to:
                 - dev@domain.net
                 - graph@domain.net
               subject: notice to emerg errors raised by sfView
           file:
             - level: 0 # SF_LOG_EMERG
               file: %SF_LOG_DIR%/emerg.log
             - min_level: 5 # SF_LOG_NOTICE and up
               file: %SF_LOG_DIR%/notice_and_up.log
             - type: [PHP, Exception] # Only PHP and uncaught exception
               file: %SF_LOG_DIR%/php.log
             - min_level: 5 # SF_LOG_NOTICE and up
               type: View
               file: %SF_LOG_DIR%/view.log
    }}}

  * Clear the cache

    {{{
      symfony cc
    }}}

  * You&#039;re done.

== Configuration ==
 
&#039;&#039;&#039;php_level : &#039;&#039;&#039; The PHP error mask to log. [http://fr3.php.net/manual/en/ref.errorfunc.php#ini.error-reporting Click for more information]

&#039;&#039;&#039;exception : &#039;&#039;&#039; Log the uncaught exceptions

&#039;&#039;&#039;email : &#039;&#039;&#039; Send errors by email

  * &#039;&#039;&#039;level : &#039;&#039;&#039; Only log this level of error [http://www.csh.rit.edu/~jon/projects/pear/Log/guide.html#log-levels Click for more information]
  
  * &#039;&#039;&#039;min_level : &#039;&#039;&#039; Log errors starting at this level
  
  * &#039;&#039;&#039;type : &#039;&#039;&#039; Log error of this type ( &#039;{TYPE} error message&#039; ). You can use an array for multiple type

  * &#039;&#039;&#039;no_type : &#039;&#039;&#039; Don&#039;t log error of this type. You can use an array for multiple type
  
  * &#039;&#039;&#039;to : &#039;&#039;&#039; To Email address. You can use an array
  
  * &#039;&#039;&#039;from : &#039;&#039;&#039; From email address
  
  * &#039;&#039;&#039;subject : &#039;&#039;&#039; Email subject
  
&#039;&#039;&#039;file : &#039;&#039;&#039; Log error on file

  * &#039;&#039;&#039;level : &#039;&#039;&#039; See definition from the &#039;&#039;&#039;email&#039;&#039;&#039; section

  * &#039;&#039;&#039;min_level : &#039;&#039;&#039; See definition from the &#039;&#039;&#039;email&#039;&#039;&#039; section

  * &#039;&#039;&#039;type : &#039;&#039;&#039; See definition from the &#039;&#039;&#039;email&#039;&#039;&#039; section

  * &#039;&#039;&#039;no_type : &#039;&#039;&#039; See definition from the &#039;&#039;&#039;email&#039;&#039;&#039; section
  
  * &#039;&#039;&#039;file : &#039;&#039;&#039; The file name for the logs

You can combine any options from &#039;&#039;&#039;email&#039;&#039;&#039; and &#039;&#039;&#039;file&#039;&#039;&#039; section to match your wishes :

== Exemple ==

To send by email any PHP warnings and log into file other warnings :

	{{{
  all:
    loggers:
      sf_advanced_logger:
         class: sfAdvancedLogger
         param:
           php_level: 2 # E_WARNING
           email:
             - level: 4 # SF_LOG_WARNING
               type: PHP
               to: alertes@domain.net
               from: no-reply@domain.net
               subject: PHP Warning
           file:
             - level: 4 # SF_LOG_WARNING
               no_type: PHP
               file: %SF_LOG_DIR%/warning.log
	}}}

== Bugs or features requests ==

Please, submit any bugs or features requests on the [http://www.symfony-project.com/forum/index.php/t/8952/ forum]

== Changelog ==

=== 2007-09-26 | 0.1.0 ===

 * romain: plug-in added to symfony