ThinkPHP日志记录

ThinkPHP日志记录

（摘自TP手册）

日志的处理工作是由系统自动进行的，在开启日志记录的情况下，会记录下允许的日志级别的所有日志信息。

其中，为了性能考虑，SQL日志级别必须在调试模式开启下有效，否则就不会记录。 系统的日志记录由核心的Think\Log类及其驱动完成，提供了多种方式记录了不同的级别的日志信息。

默认情况下只是在调试模式记录日志，要在部署模式开启日志记录，必须在配置中开启LOG_RECORD参数，以及可以在应用配置文件中配置需要记录的日志级别，例如：

1. 'LOG_RECORD' => true, // 开启日志记录
2. 'LOG_LEVEL' =>'EMERG,ALERT,CRIT,ERR', // 只记录EMERG ALERT CRIT ERR 错误

日志的记录并非实时保存的，只有当当前请求完成或者异常结束后才会实际写入日志信息，否则只是记录在内存中。

日志级别

ThinkPHP对系统的日志按照级别来分类，包括：

• EMERG 严重错误，导致系统崩溃无法使用
• ALERT 警戒性错误， 必须被立即修改的错误
• CRIT 临界值错误， 超过临界值的错误
• ERR 一般性错误
• WARN 警告性错误， 需要发出警告的错误
• NOTICE 通知，程序可以运行但是还不够完美的错误
• INFO 信息，程序输出信息
• DEBUG 调试，用于调试信息
• SQL SQL语句，该级别只在调试模式开启时有效

记录方式

日志的记录方式默认是文件方式，可以通过驱动的方式来扩展支持更多的记录方式。

记录方式由LOG_TYPE参数配置，例如：

1. 'LOG_TYPE' => 'File', // 日志记录类型 默认为文件方式

File方式记录，对应的驱动文件位于系统的Library/Think/Log/Driver/File.class.php。

手动记录

一般情况下，系统的日志记录是自动的，无需手动记录，但是某些时候也需要手动记录日志信息，Log类提供了3个方法用于记录日志。

方法	描述
Log::record()	记录日志信息到内存
Log::save()	把保存在内存中的日志信息（用指定的记录方式）写入
Log::write()	实时写入一条日志信息

由于系统在请求结束后会自动调用Log::save方法，所以通常，你只需要调用Log::record记录日志信息即可。

record方法用法如下：

1. \Think\Log::record('测试日志信息');

默认的话记录的日志级别是ERR，也可以指定日志级别：

1. \Think\Log::record('测试日志信息，这是警告级别','WARN');

record方法只会记录当前配置允许记录的日志级别的信息，如果应用配置为：

1. 'LOG_LEVEL' =>'EMERG,ALERT,CRIT,ERR', // 只记录EMERG ALERT CRIT ERR 错误

那么上面的record方法记录的日志信息会被直接过滤，或者你可以强制记录：

1. \Think\Log::record('测试日志信息，这是警告级别','WARN',true);

采用record方法记录的日志信息不是实时保存的，如果需要实时记录的话，可以采用write方法，例如：

1. \Think\Log::write('测试日志信息，这是警告级别，并且实时写入','WARN');

write方法写入日志的时候 不受配置的允许日志级别影响，可以实时写入任意级别的日志信息。