thinkphp8 开启调试模式并查看 trace 信息,需要在 .env 环境变量文件中将 app_debug 设置为 true。开启后,页面底部会自动渲染包含请求参数、sql 执行语句和性能统计的 trace 面板,方便开发者排查问题。

如何配置环境变量以启用 Debug 模式
在 ThinkPHP8 中,调试模式的开关由应用配置文件或环境变量控制。最直接且推荐的方式是修改项目根目录下的 .env 文件。找到 app_debug 配置项,将其值从 false 改为 true。如果项目中没有 .env 文件,可以复制 .env.example 并重命名。修改完成后,无需重启服务,刷新页面即可生效。此时,页面底部会显示一个可折叠的 Trace 面板,点击展开即可查看详细的运行日志。

APP_DEBUG=true APP_TRACE=true APP_STATUS_CACHE=false
上述代码展示了 .env 文件中的关键配置。APP_DEBUG 开启全局调试模式,允许显示错误堆栈和 Trace 信息。APP_TRACE 确保 Trace 面板被激活。APP_STATUS_CACHE 建议关闭,以避免缓存导致配置更新不及时。保存文件后,访问任意路由,页面底部即会出现蓝色的 Trace 标签页。
立即学习“PHP免费学习笔记(深入)”;
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
Trace 面板中包含哪些关键信息
开启调试模式后,Trace 面板提供了多维度的运行时数据。主要包含“请求信息”、“文件包含”、“性能统计”、“SQL 语句”和“环境变量”等标签页。“请求信息”展示了 HTTP 方法、URL、IP 地址及输入参数。“性能统计”列出了各阶段的耗时,帮助定位瓶颈。“SQL 语句”标签页记录了当前请求执行的所有数据库操作及其执行时间,这是排查慢查询和数据问题的核心区域。此外,如果启用了日志记录,还可以查看具体的错误日志内容。

// 控制器示例
namespace app\controller;
use think\facade\Db;
class Index {
public function index() {
$data = Db::name('user')->select();
return json($data);
}
}
以上是一个简单的控制器示例。当访问该接口时,Trace 面板的“SQL 语句”标签页会记录 SELECT * FROM user 的执行情况,包括执行时间(如 0.5ms)和返回行数。开发者可以通过这些信息确认 SQL 是否正确生成,以及是否存在 N+1 查询问题。若需进一步分析,可结合日志文件查看更详细的异常堆栈。
如何在特定条件下仅查看 SQL 执行记录
在实际开发中,有时只需要关注数据库交互,而不需要完整的 Trace 面板。可以通过配置 trace 类型来过滤显示内容。在 .env 或配置文件中设置 app_trace 为 sql,或者在代码中动态调整。例如,在 config/trace.php 中指定只记录 SQL。这样,页面底部的 Trace 面板将简化为仅展示 SQL 执行列表,减少视觉干扰,提高排查效率。此设置不影响其他调试功能,仅改变前端展示内容。


















