Class TLogger
TLogger class.
TLogger records log messages in memory and implements the methods to retrieve the messages with filter conditions, including log levels and log categories.
Method Summary |
void
|
getLogs
( integer $levels, string $categories, array 2)
Retrieves log messages.
|
void
|
log
( string $message, integer $level, string $category)
Logs a message.
|
Methods Inherited From TComponent |
TComponent::addParsedObject(), TComponent::attachEventHandler(), TComponent::canGetProperty(), TComponent::canSetProperty(), TComponent::createdOnTemplate(), TComponent::detachEventHandler(), TComponent::evaluateExpression(), TComponent::evaluateStatements(), TComponent::getEventHandlers(), TComponent::getSubProperty(), TComponent::hasEvent(), TComponent::hasEventHandler(), TComponent::hasProperty(), TComponent::raiseEvent(), TComponent::setSubProperty(), TComponent::__get(), TComponent::__set()
|
Method Details |
getLogs
public void getLogs |
(integer $levels , string $categories , array 2 ) |
Retrieves log messages.
Messages may be filtered by log levels and/or categories. A level filter is specified by an integer, whose bits indicate the levels interested. For example, (TLogger::INFO | TLogger::WARNING) specifies INFO and WARNING levels. A category filter is specified by concatenating interested category names with commas. A message whose category name starts with any filtering category will be returned. For example, a category filter 'System.Web, System.IO' will return messages under categories such as 'System.Web', 'System.IO', 'System.Web.UI', 'System.Web.UI.WebControls', etc. Level filter and category filter are combinational, i.e., only messages satisfying both filter conditions will they be returned.
Input |
integer | $levels | level filter |
string | $categories | category filter |
array | 2 | list of messages. Each array elements represents one message with the following structure: array( [0] => message [1] => level [2] => category [3] => timestamp (by microtime(), float number)); |
Output |
Exception |
|
log
public void log |
(string $message , integer $level , string $category ) |
Logs a message.
Messages logged by this method may be retrieved via getLogs.
Input |
string | $message | message to be logged |
integer | $level | level of the message. Valid values include TLogger::DEBUG, TLogger::INFO, TLogger::NOTICE, TLogger::WARNING, TLogger::ERROR, TLogger::ALERT, TLogger::FATAL. |
string | $category | category of the message |
Output |
Exception |
|
Constant Details |
ALERT
|
DEBUG
Log levels.
|
ERROR
|
FATAL
|
INFO
|
NOTICE
|
WARNING
|
|