Classe: LoggerManager  - X-Ref

\ingroup logger

The logger manages a bunch of loggers configured in the config/logging.properties.php file.
By default if no loggers are specified it will create one logger called "default".
In order to define new loggers, the configuration file has to look like this:

<pre>
$config["logger_name"] = Array(
"appender" => "name_of_the_appender_class",
"layout"   => "a pattern definition for the log messages",
"file"     => "file_for_fileappender",
"prio"     => "debug" );
</pre>

Where "logger_name" is the identifer that we will use later on in the call to
LoggerManager::getLogger() later on to retrieve a handle to this particular logger.

The available appenders are: "file", "stdout", "null"
The FileAppender   class writes data to a log file, which must be specified via a
property called "file"
The StdoutAppender class writes data to the console
The NullAppender   does not write data anywhere, it's a "dumb" logger that does nothing.
If you do not want a logfile to be written, but want to safe your
configuration, just change the appender from 'file' to 'null' :-)

Layout formats:
PatternLayout: allows to specify a pattern for our messages. Patterns are specified as follows:
<ul>
<li><b>%c</b>               - the class where message was logged</li>
<li><b>%d</b>               - current date</li>
<li><b>%f</b>               - the file where the message was logged</li>
<li><b>%F</b>               - the function where the message was
logged</li>
<li><b>%l</b>               - the line where the message was logged</li>
<li><b>%m</b>               - the log message</li>
<li><b>%n</b>               - a newline</li>
<li><b>%N</b>               - the level name</li>
<li><b>%p</b>               - the level of priority</li>
<li><b>%r</b>               - a carriage return</li>
<li><b>%t</b>               - a horizontal tab</li>
<li><b>%T</b>               - a unix timestamp (seconds since January 1st, 1970)</li>
</ul>

The available priorities are: error > warn > info

NOTE: There can only be one appender and one layout class per logger.

In order to retrieve a handle to one of our loggers later on in our code, we should use
LoggerManager::getLogger()

<pre>
$log =& LoggerManager::getLogger( "logger_name" );
$log->debug( $message );
...
$log->info( $message );
</pre>