CLogRouter
| 包 | system.logging |
|---|---|
| 继承 | class CLogRouter » CApplicationComponent » CComponent |
| 实现 | IApplicationComponent |
| 可用自 | 1.0 |
| 源码 | framework/logging/CLogRouter.php |
CLogRouter manages log routes that record log messages in different media.
For example, a file log route CFileLogRoute records log messages in log files. An email log route CEmailLogRoute sends log messages to specific email addresses. See CLogRoute for more details about different log routes.
Log routes may be configured in application configuration like following:
You can specify multiple routes with different filtering conditions and different targets, even if the routes are of the same type.
For example, a file log route CFileLogRoute records log messages in log files. An email log route CEmailLogRoute sends log messages to specific email addresses. See CLogRoute for more details about different log routes.
Log routes may be configured in application configuration like following:
array(
'preload'=>array('log'), // preload log component when app starts
'components'=>array(
'log'=>array(
'class'=>'CLogRouter',
'routes'=>array(
array(
'class'=>'CFileLogRoute',
'levels'=>'trace, info',
'categories'=>'system.*',
),
array(
'class'=>'CEmailLogRoute',
'levels'=>'error, warning',
'emails'=>array('admin@example.com'),
),
),
),
),
)
You can specify multiple routes with different filtering conditions and different targets, even if the routes are of the same type.
公共属性
| 属性 | 类型 | 描述 | 被定义在 |
|---|---|---|---|
| behaviors | array | the behaviors that should be attached to this component. | CApplicationComponent |
| isInitialized | boolean | Checks if this application component has been initialized. | CApplicationComponent |
| routes | array | the currently initialized routes | CLogRouter |
公共方法
| 方法 | 描述 | 被定义在 |
|---|---|---|
| __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() | Collects log messages from a logger. | CLogRouter |
| 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 |
| evaluateExpression() | Evaluates a PHP expression or callback under the context of this component. | CComponent |
| getEventHandlers() | Returns the list of attached event handlers for an event. | CComponent |
| getIsInitialized() | Checks if this application component has been initialized. | CApplicationComponent |
| getRoutes() | Returns the currently initialized routes | CLogRouter |
| 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 this application component. | CLogRouter |
| processLogs() | Collects and processes log messages from a logger. | CLogRouter |
| raiseEvent() | Raises an event. | CComponent |
| setRoutes() | Sets list of route configurations. Each array element represents
the configuration for a single route and has the following array structure:
|
CLogRouter |
属性详情
routes
属性
the currently initialized routes
方法详情
collectLogs()
方法
|
public void collectLogs(CEvent $event)
| ||
| $event | CEvent | event parameter |
源码： framework/logging/CLogRouter.php#100 (显示)
public function collectLogs($event)
{
$logger=Yii::getLogger();
$dumpLogs=isset($event->params['dumpLogs']) && $event->params['dumpLogs'];
foreach($this->_routes as $route)
{
/* @var $route CLogRoute */
if($route->enabled)
$route->collectLogs($logger,$dumpLogs);
}
}
Collects log messages from a logger. This method is an event handler to the CLogger::onFlush event.
getRoutes()
方法
|
public array getRoutes()
| ||
| {return} | array | the currently initialized routes |
源码： framework/logging/CLogRouter.php#76 (显示)
public function getRoutes()
{
return new CMap($this->_routes);
}
init()
方法
|
public void init()
|
源码： framework/logging/CLogRouter.php#60 (显示)
public function init()
{
parent::init();
foreach($this->_routes as $name=>$route)
{
$route=Yii::createComponent($route);
$route->init();
$this->_routes[$name]=$route;
}
Yii::getLogger()->attachEventHandler('onFlush',array($this,'collectLogs'));
Yii::app()->attachEventHandler('onEndRequest',array($this,'processLogs'));
}
Initializes this application component. This method is required by the IApplicationComponent interface.
processLogs()
方法
（自版本 v1.1.0 可用）
|
public void processLogs()
|
源码： framework/logging/CLogRouter.php#117 (显示)
public function processLogs()
{
$logger=Yii::getLogger();
$logger->flush(true);
}
Collects and processes log messages from a logger. This method is an event handler to the CApplication::onEndRequest event.
setRoutes()
方法
|
public void setRoutes(array $config)
| ||
| $config | array | list of route configurations. Each array element represents
the configuration for a single route and has the following array structure:
|
源码： framework/logging/CLogRouter.php#89 (显示)
public function setRoutes($config)
{
foreach($config as $name=>$route)
$this->_routes[$name]=$route;
}