Yii 提供了一个灵活可扩展的日志功能。记录的日志 可以通过日志级别和信息分类进行归类。通过使用 级别和分类过滤器,所选的信息还可以进一步路由到 不同的目的地,例如一个文件,Email,浏览器窗口等。
信息可以通过 Yii::log 或 Yii::trace 记录。其 区别是后者只在当应用程序运行在 调试模式(debug mode) 中时才会记录信息。
Yii::log($message,$level,$category);Yii::trace($message,$category);
当记录信息时,我们需要指定它的分类和级别 分类是一段格式类似于 路径别名 的字符串。 例如,如果一条信息是在 CController 中记录的,我们可以使用 system.web.CController 作为分类。信息级别应该是下列值中的一种:
trace: 这是在 Yii::trace 中使用的级别。它用于在开发中 跟踪程序的执行流程。
info: 这个用于记录普通的信息。
profile: 这个是性能概述(profile)。下面马上会有更详细的说明。
warning: 这个用于警告(warning)信息。
error: 这个用于致命错误(fatal error)信息。
2. 信息路由
通过 Yii::log 或 Yii::trace 记录的信息是保存在内存中的。 我们通常需要将它们显示到浏览器窗口中,或者将他们保存到一些 持久存储例如文件、Email中。这个就叫作 信息路由,例如, 发送信息到不同的目的地。
在 Yii 中,信息路由是由一个叫做 CLogRouter 的应用组件管理的。 它负责管理一系列称作 日志路由 的东西。每个日志路由 代表一个单独的日志目的地。通过一个日志路由发送的信息会被他们的级别和分类过滤。
要使用信息路由,我们需要安装并预加载一个 CLogRouter 应用组件。我们也还需要配置它的 routes 属性为我们想要的那些日志路由。 下面的代码演示了一个所需的 应用配置 示例:
array(......
'preload'=>array('log'),
'components'=>array(......
'log'=>array('class'=>'CLogRouter',
'routes'=>array(array('class'=>'CFileLogRoute',
'levels'=>'trace, info',
'categories'=>'system.*',),
array('class'=>'CEmailLogRoute',
'levels'=>'error, warning',
'emails'=>'admin@example.com',),),),),)
在上面的例子中,我们定义了两个日志路由。第一个是 CFileLogRoute ,它会把信息保存在位于应用程序 runtime 目录中的一个文件中。 而且只有级别为 trace 或 info 、分类以 system. 开头的信息才会被保存。 第二个路由是 CEmailLogRoute ,它会将信息发送到指定的 email 地址,且只有级别为 error 或 warning 的才会发送。
在 Yii 中,有下列几种日志路由可用:
CDbLogRoute: 将信息保存到数据库的表中。
CEmailLogRoute: 发送信息到指定的 Email 地址。
CFileLogRoute: 保存信息到应用程序 runtime 目录中的一个文件中。
CWebLogRoute: 将 信息 显示在当前页面的底部。
CProfileLogRoute: 在页面的底部显示概述(profiling)信息。
3. 信息过滤
正如我们所提到的,信息可以在他们被发送到一个日志路由之前通过它们的级别和分类过滤。 这是通过设置对应日志路由的 levels 和 categories 属性完成的。 多个级别或分类应使用逗号连接。
由于信息分类是类似 xxx.yyy.zzz 格式的,我们可以将其视为一个分类层级。 具体地,我们说 xxx 是 xxx.yyy的父级,而xxx.yyy 又是 xxx.yyy.zzz 的父级。 这样我们就可以使用 xxx.* 表示分类 xxx 及其所有的子级和孙级分类。
public function actionTest()
{
Yii::log("this is a info log",'info','userlog');
}
array(
'class'=>'CFileLogRoute',
'levels'=>'trace,info',
'categories'=>'userlog',
'logFile'=>'log.txt',
),
运行时在runtime目录下生产log.txt文件:内容为:
2014/03/31 21:49:23 [info] [userlog] this is a info log
in F:\xampp\htdocs\php\yiiblog2\protected\controllers\LogController.php (6)
in F:\xampp\htdocs\php\yiiblog2\index.php (14)
可以配置那里增加一个'runtimePath'=>目录/'tmp/',
日志文件就会放在这里了。
array(
'class'=>'CFileLogRoute',
'levels'=>CLogger::LEVEL_ERROR,
'logFile'=>'error.txt',
'maxFileSize' => '1024',
),
错误会输出到error。txt文件里。
一篇文章:
一直对Yii文件日志的配置没有关注,基本上都是默认配置,最近发现所有日志都写在一个文件里,并且日志文件都保存在Yii项目的runtime目录下,查看非常不方便,于是想将不同类型的日志进行拆分,并且单独放入空间较大的数据盘,稍微看了一下Yii的文件日志类,测试了一下相关配置,觉得配置还挺方便的,记录下来:
在main.php文件中,配置日志的地方
配置:'log'=>array('class'=>'CLogRouter',
'routes'=>array(array('class'=>'CFileLogRoute',
'levels'=>'error, warning, info',
'categories'=> 'application.*',//日志文件分类,只有调用时使用了appplication都会默认写入默认文件application.log
'logPath'=>'/mnt/php/logs', //日志文件路径 要用绝对路径,
'maxFileSize'=>5120,//日志大小
'maxLogFiles'=>20,//保存最大个数,Yii会按时间保留最近20个文件
),
array('class' => 'CFileLogRoute',
'levels' => 'error, warning,info',
'categories'=> 'db.*',//日志文件分类,db相关
'logFile'=> 'db.log',//保存数据库操作相关日志
'logPath'=>'/mnt/php/logs', //日志文件路径
'maxFileSize'=>5120,//日志大小5M,以kb为单位的
'maxLogFiles'=>20,),
array('class' => 'CFileLogRoute',
'levels' => 'trace',
'categories'=> 'debug.*',
'logFile'=> 'debug.log',//保存debug日志
'logPath'=>'/mnt/php/logs',
'maxFileSize'=>5120,
'maxLogFiles'=>20,),)
),调用://默认写入application.log
Yii::log($content,CLogger::LEVEL_INFO);//将$content写入/mnt/php/logs/debug.log,级别为trace
Yii::log($content,CLogger::LEVEL_TRACE,'debug');//以下三种写法都会将$content写入/mnt/php/logs/db.log,并且在每行日志前面会使用db.model1,
//db.model2,db.model3区分,级别均为error
Yii::log($content,CLogger::LEVEL_ERROR,'db.model1');
Yii::log($content,CLogger::LEVEL_ERROR,'db.model2');
Yii::log($content,CLogger::LEVEL_ERROR,'db.model3');
源码:framework/logging/CFileLogRoute.php/**
* @var integer maximum log file size*/
private $_maxFileSize=1024; //in KB
/**
* @var integer number of log files used for rotation*/
private $_maxLogFiles=5;/**
* @var string directory storing log files*/
private $_logPath;/**
* @var string log file name*/
private $_logFile='application.log';
这几个参数都提供了get和set方法,所以可以在配置里面配置即可
另外一些参数可以参考父类:framework/logging/CLogRoute.php/**
* @var string list of levels separated by comma or space. Defaults to empty, meaning all levels.*/
public $levels='';/**
* @var mixed array of categories, or string list separated by comma or space.
* Defaults to empty array, meaning all categories.*/
public $categories=array();
应该还有一些可以配置,暂时无用到,没做深入研究了
输出包含几个属性:时间 [日志级别] [日志的分类] 日志内容.
Yii2日志:
http://www.cnblogs.com/rhythmK/p/4479246.html