调试模式并不能完全满足我们调试的需要,有时候我们需要手动的输出一些调试信息。除了本身可以借助一些开发工具进行调试外,HulaCWMS还提供了一些内置的调试工具和函数。
`Trace`调试功能就是HulaCWMS提供给开发人员的一个用于开发调试的辅助工具。可以实时显示当前页面或者请求的请求信息、运行情况、SQL执行、错误信息和调试信息等,并支持自定义显示,并且支持没有页面输出的操作调试。
> Trace调试功能对调试模式和部署模式都有效,可以单独开启和关闭。
> 只是在部署模式下面,显示的调试信息没有调试模式完整,通常我们建议Trace配合调试模式一起使用。
## 开启Trace调试
该功能默认关闭,要开启Trace调试功能,只需要在应用配置`app.php`文件中配置下面参数:
~~~
// 开启应用Trace调试
'app_trace' => true,
~~~
> 如果定义了环境变量`APP_TRACE`,那么以环境变量配置为准。
## 浏览器控制台输出
页面Trace功能开启后,你可以打开浏览器的开发人员工具(F12快捷键打开)在Console面板中查看输出的Trace信息。
![](https://box.kancloud.cn/2016-06-29_5773d44908266.png)
Trace框架有6个选项卡,分别是基本、文件、流程、错误、SQL和调试,点击不同的选项卡会切换到不同的Trace信息窗口。
| 选项卡 | 描述 |
| --- | --- |
| 基本 | 当前页面的基本摘要信息,例如执行时间、内存开销、文件加载数、查询次数等等 |
| 文件 | 详细列出当前页面执行过程中加载的文件及其大小 |
| 流程 | 会列出当前页面执行到的行为和相关流程 |
| 错误 | 当前页面执行过程中的一些错误信息,包括警告错误 |
| SQL | 当前页面执行到的SQL语句信息 |
| 调试 | 开发人员在程序中进行的调试输出 |
浏览器Trace输出同样支持`trace_tabs`设置。
>[danger]在网站正式发布时,不要忘记关闭Trace调试!