CLogRoute
| 包 | system.logging |
|---|---|
| 继承 | abstract class CLogRoute » CComponent |
| 子类 | CDbLogRoute, CEmailLogRoute, CFileLogRoute, CWebLogRoute |
| 可用自 | 1.0 |
| 版本 | $Id$ |
A log route object retrieves log messages from a logger and sends it somewhere, such as files, emails. The messages being retrieved may be filtered first before being sent to the destination. The filters include log level filter and log category filter.
To specify level filter, set levels property, which takes a string of comma-separated desired level names (e.g. 'Error, Debug'). To specify category filter, set categories property, which takes a string of comma-separated desired category names (e.g. 'System.Web, System.IO').
Level filter and category filter are combinational, i.e., only messages satisfying both filter conditions will they be returned.
公共属性
| 属性 | 类型 | 描述 | 被定义在 |
|---|---|---|---|
| categories | string | list of categories separated by comma or space. | CLogRoute |
| enabled | boolean | whether to enable this log route. | CLogRoute |
| filter | mixed | the additional filter (e. | CLogRoute |
| levels | string | list of levels separated by comma or space. | CLogRoute |
公共方法
| 方法 | 描述 | 被定义在 |
|---|---|---|
| __call() | Calls the named method which is not a class method. | CComponent |
| __get() | Returns a property value, an event handler list or a behavior based on its name. | CComponent |
| __isset() | Checks if a property value is null. | CComponent |
| __set() | Sets value of a component property. | CComponent |
| __unset() | Sets a component property to be null. | CComponent |
| asa() | Returns the named behavior object. | CComponent |
| attachBehavior() | Attaches a behavior to this component. | CComponent |
| attachBehaviors() | Attaches a list of behaviors to the component. | CComponent |
| attachEventHandler() | Attaches an event handler to an event. | CComponent |
| canGetProperty() | Determines whether a property can be read. | CComponent |
| canSetProperty() | Determines whether a property can be set. | CComponent |
| collectLogs() | Retrieves filtered log messages from logger for further processing. | CLogRoute |
| detachBehavior() | Detaches a behavior from the component. | CComponent |
| detachBehaviors() | Detaches all behaviors from the component. | CComponent |
| detachEventHandler() | Detaches an existing event handler. | CComponent |
| disableBehavior() | Disables an attached behavior. | CComponent |
| disableBehaviors() | Disables all behaviors attached to this component. | CComponent |
| enableBehavior() | Enables an attached behavior. | CComponent |
| enableBehaviors() | Enables all behaviors attached to this component. | CComponent |
| getEventHandlers() | Returns the list of attached event handlers for an event. | CComponent |
| hasEvent() | Determines whether an event is defined. | CComponent |
| hasEventHandler() | Checks whether the named event has attached handlers. | CComponent |
| hasProperty() | Determines whether a property is defined. | CComponent |
| init() | Initializes the route. | CLogRoute |
| raiseEvent() | Raises an event. | CComponent |
受保护的方法
| 方法 | 描述 | 被定义在 |
|---|---|---|
| formatLogMessage() | Formats a log message given different fields. | CLogRoute |
| processLogs() | Processes log messages and sends them to specific destination. | CLogRoute |
属性详情
list of categories separated by comma or space. Defaults to empty, meaning all categories.
whether to enable this log route. Defaults to true.
the additional filter (e.g. CLogFilter) that can be applied to the log messages. The value of this property will be passed to Yii::createComponent to create a log filter object. As a result, this can be either a string representing the filter class name or an array representing the filter configuration. In general, the log filter class should be CLogFilter or a child class of it. Defaults to null, meaning no filter will be used.
list of levels separated by comma or space. Defaults to empty, meaning all levels.
方法详情
|
public void collectLogs(CLogger $logger)
| ||
| $logger | CLogger | logger instance |
Retrieves filtered log messages from logger for further processing.
|
protected string formatLogMessage(string $message, integer $level, string $category, integer $time)
| ||
| $message | string | message content |
| $level | integer | message level |
| $category | string | message category |
| $time | integer | timestamp |
| {return} | string | formatted message |
Formats a log message given different fields.
|
public void init()
|
Initializes the route. This method is invoked after the route is created by the route manager.
|
abstract protected void processLogs(array $logs)
| ||
| $logs | array | list of messages. Each array elements represents one message with the following structure: array( [0] => message (string) [1] => level (string) [2] => category (string) [3] => timestamp (float, obtained by microtime(true)); |
Processes log messages and sends them to specific destination. Derived child classes must implement this method.