Log

<br/> >i 本文档的最新修订日期是: > **2022-07-20** # Log ## 模块简述 将日志进行保存。 >w 本模块在写入文件时会执行 <font color="#c7254e">`加锁操作`</font> ,因此不保证能够记录到每一个访问数据。请务必确保Temp目录具有 <font color="#c7254e">`读写权限`</font> 。 >w 本模块依赖于 <font color="#c7254e">`安全码`</font> 设置,如果安全码的值不符合要求,本功能将不会启用。 >d 如设置不当,日志可能会占用大量硬盘存储空间,请谨慎操作! ## 模块配置 配置文件位于 <font color="#c7254e">`/config/core/Log.php`</font> 。 * **<font color="#ff6600">`interval`</font>** <font color="#0099ff">`(String)`</font> <font color="#bbbbbb">`'H'`</font> : 单个文件的记录时长。 可选的值是 <font color="#c7254e">`H/M/MH`</font> ,分别代表 <font color="#c7254e">`小时/分钟/30秒`</font> ,即每小时/每分钟/每30秒内的所有记录作为一个文件存储。除此之外的任何值,框架将不会进行文件分页。 * **<font color="#ff6600">`access`</font>** <font color="#0099ff">`(Bool)`</font> <font color="#bbbbbb">`FALSE`</font> : 用以指定是否将客户端的信息(IP、访问路径、UA、Referer等)记录到日志中。 * **<font color="#ff6600">`level`</font>** <font color="#0099ff">`(String)`</font> <font color="#bbbbbb">`error`</font> : 用以指定写入日志文件的等级,可选的值如下: ``` debug | info | notice | warning | error ``` 日志级别在上面已经按严重性由轻到重的顺序列出。设置为某个日志级别将会使指定级别和更高级别的日志都被记录下来。 比如,指定级别为info,会使框架将所有info、notice、warning、error级别的日志写入日志文件。 ## :: add()方法 ### 语法 **<font color="#0099ff"><font color="#ff6600">Log</font> :: <font color="#ff6600">add</font> ( <kbd>传参数组</kbd> )</font>** ### 说明 向内存中添加一条日志。 此方法 <font color="#c7254e">`支持`</font> 中文参数名。 ### 参数 * **<font color="#ff6600">`info(内容)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`''`</font>: 用以指定日志内容。 * **<font color="#ff6600">`level(等级)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`'info'`</font>: 用以指定日志的等级。可选的值如下: ``` debug | info | notice | warning | error ``` 日志级别在上面已经按严重性由轻到重的顺序列出。 ### 返回 <font color="#0099ff">`(Bool)`</font> 类型。 返回的值为 <font color="#c7254e">`TRUE`</font> 时代表操作成功,值为 <font color="#c7254e">`FALSE`</font> 时代表传入的参数是一个不存在的日志等级,因此操作失败。 ### 示例 向日志中添加一条等级为 <font color="#c7254e">`错误(error)`</font> 级别的日志: ```php $Config=array( '内容'=>'未经授权的访问!', '等级'=>'error' ); Log::add($Config); ``` ## :: output()方法 ### 语法 **<font color="#0099ff"><font color="#ff6600">Log</font> :: <font color="#ff6600">output</font> ( )</font>** ### 说明 向硬盘写入当前内存中已累积的日志后,清空内存中已累积的日志。 在每次页面执行结束后,框架会自动执行此方法。 此方法 <font color="#c7254e">`支持`</font> 中文参数名。 ### 参数 无。 ### 返回 无。 ## :: clean()方法 ### 语法 **<font color="#0099ff"><font color="#ff6600">Log</font> :: <font color="#ff6600">clean</font> ( )</font>** ### 说明 清空内存中已累积的日志。 ### 参数 无。 ### 返回 无。 ## :: get()方法 ### 语法 **<font color="#0099ff"><font color="#ff6600">Log</font> :: <font color="#ff6600">get</font> ( )</font>** ### 说明 获取当前已累积的日志。 ### 参数 无。 ### 返回 <font color="#0099ff">`(Array)`</font> 类型。 返回当前已累积的日志。