ThinkPHP 8.0手册怎么使用?页面Trace性能分析工具

陌萱大大_2964

陌萱大大_2964

2026-08-10

533人浏览

原创

要让ThinkPHP 8.0页面右下角出现可点击的Trace调试面板,必须同时满足APP_DEBUG和APP_TRACE为true,清空runtime缓存、确保.env为UTF-8无BOM编码、运行时目录可写,并访问返回HTML的路由。

thinkphp 8.0手册怎么使用?页面trace性能分析工具

要让ThinkPHP 8.0页面右下角出现可点击的Trace调试面板,必须同时满足APP_DEBUG和APP_TRACE两个环境变量为true,且清空runtime缓存、确保.env文件为UTF-8无BOM编码、运行时目录可写,并访问返回HTML的路由——缺一不可,否则图标不显示、SQL标签页为空、甚至整个面板完全不渲染。

确认并设置核心环境变量

打开项目根目录下的.env文件,用VS Code或Notepad++等支持编码选择的编辑器打开,确保另存为UTF-8无BOM格式。

在文件末尾新增两行,严格按此格式书写(等号两侧不能有空格):

APP_DEBUG=true
APP_TRACE=true

若此前在public/index.php中手动define('APP_DEBUG', true),请立即删除——TP8官方明确不鼓励该写法,它会绕过环境加载逻辑,导致APP_TRACE失效、异常处理器环境识别错乱。

彻底清空运行时缓存

执行以下操作之一即可,任选其一:

方法一:终端进入项目根目录,运行命令:
php think clear

方法二:手动删除整个runtime/目录(不是只删子目录,而是连同runtime文件夹本身一起删掉),再刷新页面。

注意:只删runtime/cache或runtime/log是无效的,必须清空整个runtime目录。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

验证Trace面板是否生效

第一步:访问一个返回HTML模板的路由,例如http://localhost:8000/或http://yourdomain.com/index,不要访问/api/开头的JSON接口——Trace面板设计上仅注入HTML响应,不会出现在JSON中。

第二步:页面右下角应出现ThinkPHP LOGO及执行时间数字(如“0.042s”)。

第三步:点击该LOGO,展开面板后检查是否包含“基本、SQL、调试”等选项卡;若SQL标签页为空,请继续执行下一步。

补全SQL日志输出能力

打开config/log.php文件,定位到return数组中的'level'配置项。

确保'sql'明确出现在level数组中,例如:

return [
  'level' => ['error', 'sql', 'notice'],
];

若使用自定义数据库连接(如读写分离),还需检查该连接配置中trace_sql是否为true(默认开启,但若曾手动关闭则需恢复)。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

数码产品性能查询
数码产品性能查询

该软件包括了市面上所有手机CPU,手机跑分情况,电脑CPU,电脑产品信息等等,方便需要大家查阅数码产品最新情况,了解产品特性,能够进行对比选择最具性价比的商品。

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

2026.11.03

0

18

Docker Desktop镜像构建教程
Docker Desktop镜像构建教程

想使用Docker Desktop将本地项目构建成Docker镜像?本专题围绕镜像构建的实际操作展开,介绍Dockerfile编写、构建命令使用、镜像标签设置和构建日志查看等内容,同时整理镜像无法生成、依赖安装失败及构建缓存异常等问题的排查思路。

2026.11.03

0

11

Docker Desktop容器创建指南
Docker Desktop容器创建指南

本专题聚焦Docker Desktop容器创建与运行配置,介绍通过本地镜像或远程镜像创建容器的方法,以及容器启动、终端访问、日志查看和基础管理等操作。针对端口冲突、参数配置不当、容器无法启动等情况,也整理了相应的排查方向。

2026.11.03

0

11

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

2026.11.03

0

17

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

2026.11.03

0

19

Tailwind CSS 常用类名怎么记
Tailwind CSS 常用类名怎么记

Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。

2026.11.03

0

12

码上飞入口地址合集
码上飞入口地址合集

本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。

2026.11.03

0

10

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

2026.11.02

20

14

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

2026.11.02

40

17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习