日志处理方式
应该养成经常查看日志文件的习惯,可以避免和及早发现很多的错误隐患。
框架日志遵循PAR-3规范
1.日志配置
2.日志写入
2-1. 手动记录
2-2.关闭日志
2-3.日志级别
2-4.上下文信息
2-5.独立日志
2-6.单文件日志
2-7.写入处理
2-8.格式化日志信息
2-9.清空日志
2-10.日志自动清理
2-11.JSON格式日志
3.日志通道
4.自定义驱动
日志配置
日志的配置文件是配置文件目录下的log.php文件,系统在进行日志写入之前会读取该配置文件进行初始化。
新版的日志配置支持多通道,默认配置如下:
return [ // 默认日志记录通道 'default' => 'file', // 日志记录级别 'level' => [], // 日志类型记录的通道 ['error'=>'email',...] 'type_channel' => [], // 日志通道列表 'channels' => [ 'file' => [ // 日志记录方式 'type' => 'File', // 日志保存目录 'path' => '', // 单文件日志写入 'single' => false, // 独立日志级别 'apart_level' => [], // 最大日志文件数量 'max_files' => 0, ], // 其它日志通道配置 ], ];
可以添加多个日志通道,每个通道可以设置不同的日志类型。
日志配置参数根据不同的日志类型有所区别,内置的日志类型包括:file、socket,日志类型使用type参数配置即可。
日志的全局配置参数包含(无论使用什么日志类型都支持):
参数 | 描述 |
---|---|
default | 默认的日志通道 |
type_channel | 日志类型记录的通道 |
type | 日志类型(或者驱动类名称) |
level | 允许记录的日志级别 |
allow_key | 允许日志写入的授权key |
close | 是否关闭日志写入 |
默认的日志类型是File方式,可以通过驱动的方式来扩展支持更多的记录方式。
文件类型日志的话,还支持下列配置参数:
参数 | 描述 |
---|---|
path | 日志存储路径 |
file_size | 日志文件大小限制(超出会生成多个文件) |
apart_level | 独立记录的日志级别 |
time_format | 时间记录格式 |
single | 是否单一文件日志 |
max_files | 最大日志文件数(超过自动清理 ) |
format | 日志输出格式 |
realtime_write | 是否实时写入 |
为了避免同一个目录下面的日志文件过多的性能问题,日志文件会自动生成日期子目录。
下面是一个log.php配置示例:
return [ // 日志记录方式,支持 file socket 或者自定义驱动类 'type' => 'File', //日志保存目录 'path' => '../logs/', //单个日志文件的大小限制,超过后会自动记录到第二个文件 'file_size' =>2097152, //日志的时间格式 'time_format' =>'c' ],
日志写入
手动记录
一般情况下,系统的日志记录是自动的,无需手动记录,但是某些时候也需要手动记录日志信息,Log类提供了3个方法用于记录日志。
方法 | 描述 |
---|---|
record() | 记录日志信息到内存 |
save() | 把保存在内存中的日志信息(用指定的记录方式)写入,并清空内存中的日志 |
write() | 实时写入一条日志信息 |
由于系统在请求结束后会自动调用Log::save方法统一进行日志信息写入,所以通常,你只需要调用Log::record记录日志信息即可。
record方法用法如下:
Log::record('测试日志信息');
默认记录的日志级别是info,也可以指定日志级别:
Log::record('测试日志信息,这是警告级别','notice');
采用record方法记录的日志信息不是实时保存的,如果需要实时记录的话,可以采用write方法,例如:
Log::write('测试日志信息,这是警告级别,并且实时写入','notice');
你可以在日志通道配置开启实时写入,每次记录日志信息的时候就会实时写入。
'file' => [ // 日志记录方式 'type' => 'File', // 日志保存目录 'path' => '', // 单文件日志写入 'single' => false, // 独立日志级别 'apart_level' => [], // 最大日志文件数量 'max_files' => 0, // 日志处理 'processor' => null, // 实时写入 'realtime_write' => true, ],
为避免内存溢出,在命令行下面执行的话日志信息会实时写入。
关闭日志
要关闭日志功能,可以配置close参数关闭全局日志写入。
return [ // 日志记录方式 'type' => 'File', // 关闭日志写入 'close' => true, ],
或者调用Log::close()方法关闭本次请求的日志写入。
// 关闭当前日志写入 Log::close();
日志级别
ThinkPHP对系统的日志按照级别来分类记录,按照PSR-3日志规范,日志的级别从低到高依次为: debug, info, notice, warning, error, critical, alert, emergency,ThinkPHP额外增加了一个sql日志级别仅用于记录SQL日志(并且仅当开启数据库调试模式有效)。
系统发生异常后记录的日志级别是error
系统提供了不同日志级别的快速记录方法,例如:
Log::error('错误信息'); Log::info('日志信息'); // 和下面的用法等效 Log::record('错误信息', 'error'); Log::record('日志信息', 'info');
还封装了一个助手函数用于日志记录,例如:
trace('错误信息', 'error'); trace('日志信息', 'info');
事实上,你可以增加自定义的日志类型,例如:
Log::record('自定义错误信息', 'diy'); trace('自定义错误信息', 'diy');
也支持指定级别日志的输入,需要配置信息:
return [ 'type' => 'File', // 日志记录级别,使用数组表示 'level' => ['error', 'alert'], ],
上面的配置表示只记录error和alert级别的日志信息。
默认情况下是不会记录HTTP异常日志(避免受一些攻击的影响写入大量日志),除非你接管了系统的异常处理,重写了report方法。
上下文信息
日志可以传入上下文信息(数组),并且被替换到日志内容中,例如:
Log::info('日志信息{user}', ['user' => '流年']);
实际写入日志的时候,{user}会被替换为流年。
独立日志
为了便于分析,File类型的日志还支持设置某些级别的日志信息单独文件记录,例如:
return [ 'type' => 'file', // error和sql日志单独记录 'apart_level' => ['error','sql'], ],
设置后,就会单独生成error 和 sql两个类型的日志文件,主日志文件中将不再包含这两个级别的日志信息。
如果apart_level设置为true,则表示所有的日志类型都会独立记录。
单文件日志
默认情况下,日志是按照日期为目录,按天为文件生成的,但如果希望仅生成单个文件(方便其它的工具或者服务读取以及分析日志)。
return [ 'single' => true, 'file_size' => 1024*1024*10, ];
开启生成单个文件后,file_size和apart_level参数依然有效,超过文件大小限制后,系统会自动生成备份日志文件。
默认的单文件日志名是single.log,如果需要更改日志文件名,可以设置
return [ 'single' => 'single_file', 'file_size' => 1024*1024*10, ];
那么实际生成的日志文件名是 single_file.log,如果设置了apart_level的话,可能还会生成 single_file.error.log之类的日志。
单文件日志也支持max_files参数设置,因为单文件日志同样会生成多个日志备份文件而导致日志文件数据过大。
写入处理
日志支持磁轭如回调处理,通过实践的方式处理。
Event::listen('think\event\LogWrite', function($event) { if('file' == $event->channel) { $event->log['info'][] = 'test info'; } });
格式化日志信息
系统提供了两个参数用于日志信息的格式化,第一个是用于自定义时间显示格式的time_format,第二个是调整日志输出格式的format参数。
return [ 'default' => 'file', 'channels' => [ 'file' => [ 'type' => 'file', 'json' => true 'file_size' => 1024*1024*10, 'time_format' => 'Y-m-d H:i:s', 'format' => '[%s][%s]:%s', ], ], ];
写入授权
日志支持写入授权,我们可以设置某个请求的日志授权Key,然后设置允许授权写入的配置Key,实现个别用户日志记录的功能,从而提高高负载下的日志记录性能。
首先需要在应用配置文件或者应用公共文件中添加当前访问的授权Key定义,例如:
// 设置IP为授权Key Log::key(Request::ip());
然后在日志配置参数中增加allow_key参数,如下:
return [ // 日志类型为File 'type' => 'File', // 授权只有202.12.36.89 才能记录日志 'allow_key' => ['202.12.36.89'], ]
清空日志
一旦执行save方法后,内存中的日志信息就会被自动清空,如果需要手动清空可以使用:
Log::clear();
在清空日志方法之前,你可以使用getLog方法获取内存中的日志。
// 获取错误类型日志 $error = Log::getLog('error'); // 获取全部日志 $logs = Log::getLog();
日志清空仅仅是清空内存中的日志。
日志自动清理
文件类型的日志支持自动清理。可以设置max_files参数,超过数量的最早日志将会自动删除。
例如,下面设置日志最多保存数量为30个
return [ 'type' => 'File', 'max_files' => 30, ];
设置max_files参数后,日志文件将不会分日期子目录存放。
JSON格式日志
可以支持JSON格式记录文件日志,更加方便一些第三方日志分析工具进行日志分析。
在日志配置文件中,添加
'json' => true
即可开启JSON格式记录,CLI命令行的日志记录同样有效。
使用JSON格式记录后,每次请求是一行JSON数据,但如果使用Log::write记录的日志是例外的单独一行JSON数据。
日志通道
你可以配置不同的日志通道,并且把不同的日志记录到不同的通道。
Log::channel('email')->info('一条测试日志'); Log::channel('socket')->error('记录错误日志');
你可以配置不同的日志类型,记录到不同的日志通道,这样在记录日志的时候会自动选择对应的通道写入。
return [ 'default' =. ‘file', 'type_channel' => [ 'error' => 'email', 'sql' => 'sql', ], 'channels' => [ 'file' => [ 'type' => 'file', ], 'email' => [ 'type' => 'email', ], 'sql' => [ 'type' => 'sql', ], ], ];
表示如果是error日志和sql日志,会分别记录到指定的通道。同时你还需要在日志配置文件中,添加email和sql日志通道的配置。核心只有file日志类型,其它的可能需要自己扩展或者安装扩展。
如果需要获取内存中的通道日志信息,可以使用
// 获取某个日志通道的日志 $error = Log::getLog('file');
可以单独关闭某个通道的日志写入,只需要把日志通道的close配置参数设置为true,或者使用方法关闭。
Log::close('file');
可以单独清空某个通道的日志