Log - APIPHP开源框架

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