日志的处理工作是由系统自动进行的,在开启日志记录的情况下,会记录下允许的日志级别的所有日志信息。
其中,为了性能考虑,SQL日志级别必须在调试模式开启下有效,否则就不会记录。 系统的日志记录由核心的Think\Log类及其驱动完成,提供了多种方式记录了不同的级别的日志信息。
默认情况下只是在调试模式记录日志,要在部署模式开启日志记录,必须在配置中开启`LOG_RECORD`参数,以及可以在应用配置文件中配置需要记录的日志级别,例如:
~~~
'LOG_RECORD' => true, // 开启日志记录
'LOG_LEVEL' =>'EMERG,ALERT,CRIT,ERR', // 只记录EMERG ALERT CRIT ERR 错误
~~~
> 日志的记录并非实时保存的,只有当当前请求完成或者异常结束后才会实际写入日志信息,否则只是记录在内存中。
## 日志级别
ThinkPHP对系统的日志按照级别来分类,包括:
- **EMERG** 严重错误,导致系统崩溃无法使用
- **ALERT** 警戒性错误, 必须被立即修改的错误
- **CRIT** 临界值错误, 超过临界值的错误
- **ERR** 一般性错误
- **WARN** 警告性错误, 需要发出警告的错误
- **NOTICE** 通知,程序可以运行但是还不够完美的错误
- **INFO** 信息,程序输出信息
- **DEBUG** 调试,用于调试信息
- **SQL** SQL语句,该级别只在调试模式开启时有效
## 记录方式
日志的记录方式默认是文件方式,可以通过驱动的方式来扩展支持更多的记录方式。
记录方式由LOG_TYPE参数配置,例如:
~~~
'LOG_TYPE' => 'File', // 日志记录类型 默认为文件方式
~~~
> File方式记录,对应的驱动文件位于系统的`Library/Think/Log/Driver/File.class.php`。
## 手动记录
一般情况下,系统的日志记录是自动的,无需手动记录,但是某些时候也需要手动记录日志信息,Log类提供了3个方法用于记录日志。
| 方法 | 描述 |
|-----|-----|
| Log::record() | 记录日志信息到内存 |
| Log::save() | 把保存在内存中的日志信息(用指定的记录方式)写入 |
| Log::write() | 实时写入一条日志信息 |
由于系统在请求结束后会自动调用Log::save方法,所以通常,你只需要调用Log::record记录日志信息即可。
record方法用法如下:
~~~
Think\Log::record('测试日志信息');
~~~
默认的话记录的日志级别是ERR,也可以指定日志级别:
~~~
Think\Log::record('测试日志信息,这是警告级别','WARN');
~~~
record方法只会记录当前配置允许记录的日志级别的信息,如果应用配置为:
~~~
'LOG_LEVEL' =>'EMERG,ALERT,CRIT,ERR', // 只记录EMERG ALERT CRIT ERR 错误
~~~
那么上面的record方法记录的日志信息会被直接过滤,或者你可以强制记录:
~~~
Think\Log::record('测试日志信息,这是警告级别','WARN',true);
~~~
采用record方法记录的日志信息不是实时保存的,如果需要实时记录的话,可以采用write方法,例如:
~~~
Think\Log::write('测试日志信息,这是警告级别,并且实时写入','WARN');
~~~
write方法写入日志的时候 不受配置的允许日志级别影响,可以实时写入任意级别的日志信息。
- 序言
- 基础
- 获取ThinkPHP
- 环境要求
- 目录结构
- 入口文件
- 自动生成
- 模块
- 控制器
- 开发规范
- 配置
- 配置格式
- 配置加载
- 读取配置
- 动态配置
- 扩展配置
- 批量配置
- 架构
- 模块化设计
- URL模式
- 多层MVC
- CBD模式
- 命名空间
- 自动加载
- 应用模式
- 项目编译
- 系统流程
- 路由
- 路由定义
- 规则路由
- 正则路由
- 静态路由
- 闭包支持
- 实例说明
- 控制器
- 控制器定义
- 前置和后置操作
- Action参数绑定
- 伪静态
- URL大小写
- URL生成
- AJAX返回
- 跳转和重定向
- 输入变量
- 请求类型
- 空操作
- 空控制器
- 插件控制器
- 操作绑定到类
- 模型
- 模型定义
- 模型实例化
- 字段定义
- 连接数据库
- 切换数据库
- 分布式数据库支持
- 连贯操作
- WHERE
- TABLE
- ALIAS
- DATA
- FIELD
- ORDER
- LIMIT
- PAGE
- GROUP
- HAVING
- JOIN
- UNION
- DISTINCT
- LOCK
- CACHE
- COMMENT
- RELATION
- USING
- fetchSql
- TOKEN
- STRICT
- INDEX
- 命名范围
- CURD操作
- 数据创建
- 数据写入
- 数据读取
- 数据更新
- 数据删除
- ActiveRecord
- 字段映射
- 查询语言
- 查询方式
- 表达式查询
- 快捷查询
- 区间查询
- 组合查询
- 统计查询
- SQL查询
- 动态查询
- 子查询
- 自动验证
- 自动完成
- 参数绑定
- 虚拟模型
- 模型分层
- 视图模型
- 关联模型
- 高级模型
- Mongo模型
- 视图
- 模板定义
- 模板主题
- 模板赋值
- 模板渲染
- 获取模板地址
- 获取内容
- 模板引擎
- 模板
- 变量输出
- 系统变量
- 使用函数
- 默认值输出
- 使用运算符
- 标签库
- 模板继承
- 修改定界符
- 三元运算
- 包含文件
- 内置标签
- Volist标签
- Foreach标签
- For标签
- Switch标签
- 比较标签
- 范围判断标签
- IF标签
- Present标签
- Empty标签
- Defined标签
- Assign标签
- Define标签
- 标签嵌套
- import标签
- 使用PHP代码
- 原样输出
- 模板注释
- 模板布局
- 模板替换
- 调试
- 调试模式
- 异常处理
- 日志记录
- 页面Trace
- Trace方法
- 变量调试
- 性能调试
- 错误调试
- 模型调试
- 缓存
- 数据缓存
- 快速缓存
- 查询缓存
- 静态缓存
- 安全
- 输入过滤
- 表单合法性检测
- 表单令牌
- 防止SQL注入
- 目录安全文件
- 保护模板文件
- 上传安全
- 防止XSS攻击
- 其他安全建议
- 扩展
- 类库扩展
- 驱动扩展
- 缓存驱动
- 数据库驱动
- 日志驱动
- Session驱动
- 存储驱动
- 模板引擎驱动
- 标签库驱动
- 行为扩展
- 标签扩展
- Widget扩展
- 应用模式
- 部署
- PATH_INFO支持
- URL重写
- 模块部署
- 域名部署
- 入口绑定
- 替换入口
- 专题
- SESSION支持
- Cookie支持
- 多语言支持
- 数据分页
- 文件上传
- 验证码
- 图像处理
- RESTFul
- RPC
- SAE
- IP获取和定位
- 附录
- 常量参考
- 配置参考
- 升级指导
- 鸣谢