ThinkPHP3.2.3完全开发手册调试日志记录
日志记录
日志的处理工作是由系统自动进行的,在开启日志记录的情况下,会记录下允许的日志级别的所有日志信息。
其中,为了性能考虑,SQL日志级别必须在调试模式开启下有效,否则就不会记录。 系统的日志记录由核心的Think\Log类及其驱动完成,提供了多种方式记录了不同的级别的日志信息。
默认情况下只是在调试模式记录日志,要在部署模式开启日志记录,必须在配置中开启LOG_RECORD
参数,以及可以在应用配置文件中配置需要记录的日志级别,例如:
'LOG_RECORD' => true, // 开启日志记录
'LOG_LEVEL' =>'EMERG,ALERT,CRIT,ERR', // 只记录EMERG ALERT CRIT ERR 错误
日志的记录并非实时保存的,只有当当前请求完成或者异常结束后才会实际写入日志信息,否则只是记录在内存中。
日志级别
ThinkPHP对系统的日志按照级别来分类,包括:
- EMERG 严重错误,导致系统崩溃无法使用
- ALERT 警戒性错误, 必须被立即修改的错误
- CRIT 临界值错误, 超过临界值的错误
- ERR 一般性错误
- WARN 警告性错误, 需要发出警告的错误
- NOTICE 通知,程序可以运行但是还不够完美的错误
- INFO 信息,程序输出信息
- DEBUG 调试,用于调试信息
- SQL SQL语句,该级别只在调试模式开启时有效
记录方式
日志的记录方式默认是文件方式,可以通过驱动的方式来扩展支持更多的记录方式。
记录方式由LOG_TYPE参数配置,例如:
'LOG_TYPE' => 'File', // 日志记录类型 默认为文件方式
File方式记录,对应的驱动文件位于系统的
Library/Think/Log/Driver/File.class.php
。
手动记录
一般情况下,系统的日志记录是自动的,无需手动记录,但是某些时候也需要手动记录日志信息,Log类提供了3个方法用于记录日志。
方法 | 描述 |
---|---|
Log::record() | 记录日志信息到内存 |
Log::save() | 把保存在内存中的日志信息(用指定的记录方式)写入 |
Log::write() | 实时写入一条日志信息 |
由于系统在请求结束后会自动调用Log::save方法,所以通常,你只需要调用Log::record记录日志信息即可。
record方法用法如下:
Think\Log::record('测试日志信息');
默认的话记录的日志级别是ERR,也可以指定日志级别:
Think\Log::record('测试日志信息,这是警告级别','WARN');
record方法只会记录当前配置允许记录的日志级别的信息,如果应用配置为:
'LOG_LEVEL' =>'EMERG,ALERT,CRIT,ERR', // 只记录EMERG ALERT CRIT ERR 错误
那么上面的record方法记录的日志信息会被直接过滤,或者你可以强制记录:
Think\Log::record('测试日志信息,这是警告级别','WARN',true);
采用record方法记录的日志信息不是实时保存的,如果需要实时记录的话,可以采用write方法,例如:
Think\Log::write('测试日志信息,这是警告级别,并且实时写入','WARN');
write方法写入日志的时候 不受配置的允许日志级别影响,可以实时写入任意级别的日志信息。