日志写入

最后更新于:2022-04-01 21:24:27

## 日志写入 |版本|新增功能| |---|---| |5.0.16|增加文件日志自动清理功能支持| |5.0.13|增加单文件日志写入功能| |5.0.10|增加`record_trace`配置参数用于记录trace信息到日志| |5.0.4|命令行模式下日志自动定时写入| ||`debug`日志类型仅用于调试模式记录| ### 手动记录 一般情况下,系统的日志记录是自动的,无需手动记录,但是某些时候也需要手动记录日志信息,Log类提供了3个方法用于记录日志。 | 方法 | 描述 | | --- | --- | | Log::record() | 记录日志信息到内存 | | Log::save() | 把保存在内存中的日志信息(用指定的记录方式)写入 | | Log::write() | 实时写入一条日志信息 | 由于系统在请求结束后会自动调用`Log::save`方法,所以通常,你只需要调用`Log::record`记录日志信息即可。 record方法用法如下: ~~~ Log::record('测试日志信息'); ~~~ 默认的话记录的日志级别是INFO,也可以指定日志级别: ~~~ Log::record('测试日志信息,这是警告级别','notice'); ~~~ 采用record方法记录的日志信息不是实时保存的,如果需要实时记录的话,可以采用write方法,例如: ~~~ Log::write('测试日志信息,这是警告级别,并且实时写入','notice'); ~~~ > V5.0.4+版本开始,为避免内存溢出,在命令行下面执行的话 日志信息会定时自动写入。 ### 日志级别 ThinkPHP对系统的日志按照级别来分类,并且这个日志级别完全可以自己定义,系统内部使用的级别包括: * **log** 常规日志,用于记录日志 * **error** 错误,一般会导致程序的终止 * **notice** 警告,程序可以运行但是还不够完美的错误 * **info** 信息,程序输出信息 * **debug** 调试,用于调试信息 * **sql** SQL语句,用于SQL记录,只在数据库的调试模式开启时有效 系统提供了不同日志级别的快速记录方法,例如: ~~~ Log::error('错误信息'); Log::info('日志信息'); // 和下面的用法等效 Log::record('错误信息','error'); Log::record('日志信息','info'); ~~~ 还封装了一个助手函数用于日志记录,例如: ~~~ trace('错误信息','error'); trace('日志信息','info'); ~~~ 也支持指定级别日志的输入,需要配置信息: ~~~ 'log' => [ 'type' => 'File', // 日志记录级别,使用数组表示 'level' => ['error'], ], ~~~ ### 单文件日志 在某些情况下,需要对日志记录进行分析和处理,那么开启单文件日志写入就会方便分析。 ~~~ 'log' => [ 'type' => 'File', // 日志记录级别,使用数组表示 'single' => true, ], ~~~ 开启后,日志文件不再区分日期文件写入,而是统一写入到`single.log`文件中。 ### 日志自动清理 `V5.0.16+`版本开始,支持文件日志的自动清理功能,你可以设置 ~~~ 'max_files' => 30 ~~~ 则日志文件最多只会保留30个,超过会自动清理较早的日志文件,避免日志文件长期写入占满磁盘空间。 >[danger] 开启自动清理功能后,不会生成日期子目录。
';