技术 · 思考 · 实践 · 成长

首页/ThinkPHP8/正文

ThinkPHP 8 调试完全指南:调试模式、页面 Trace、变量调试与 SQL 监听

ThinkPHP87 次阅读

代码跑不通、页面变慢时,得靠系统化的调试手段定位。官方手册《调试》一章下设多个子类:调试模式、页面 Trace、变量调试、SQL 调试、性能调试、断点调试。本文逐一整理,结尾附综合小实例。参考:ThinkPHP 8 调试。

一、调试模式

调试模式是所有调试信息的总开关,配置在 config/app.php 或 .env:

// config/app.php
'app_debug' => true,
# .env(不同环境各配一份,更推荐)
APP_DEBUG = true
  • 开启后:显示详细错误页、记录更多日志、暴露 SQL 与堆栈
  • 生产环境务必关闭 —— 错误显示与异常处理的细节见上一篇《日志与错误处理》

二、页面 Trace

// config/app.php
'app_trace' => true,

开启后页面右下角出现 Trace 图标,点开可以总览本次请求:耗时、内存占用、执行的 SQL、日志、加载的文件。是排查页面慢、查 N+1 查询的利器;生产环境保持关闭。

三、变量调试

dump($user);      // 格式化打印变量(类型、层级结构),不中断执行
dump($_SERVER);   // 可同时打印多个变量
halt($user);      // 打印后立即中止执行(看现场神器)

dump 比 var_dump 友好:自动格式化、保留层级;halt 相当于 dump + die,用在想看某个位置的变量值就停下的场景。

四、SQL 调试

用 Db::listen 监听执行的每条 SQL:

use thinkfacadeDb;

Db::listen(function ($sql, $runtime, $master) {
    echo $sql . ' [' . $runtime . 'ms]' . '<br>';
});

// 之后执行的 SQL 都会被监听到
Db::name('user')->where('id', 1)->find();

结合日志做慢 SQL 定位:

use thinkfacadeLog;

Db::listen(function ($sql, $runtime) {
    if ($runtime > 100) {
        Log::warning('慢SQL:' . $sql, ['time' => $runtime]);
    }
});

五、性能调试

给关键代码段计时,定位瓶颈在哪一步:

use thinkfacadeDebug;

Debug::remark('start');
// ...业务代码...
Debug::remark('end');
echo Debug::getRangeTime('start', 'end') . 's';

简单场景也可以直接用 microtime(true) 前后取差值计时;配合页面 Trace 的总耗时、内存数据一起看。

六、断点调试

  • Xdebug + PHPStorm:配置 xdebug 后可以在 IDE 里逐行断点、看变量、看调用栈,适合复杂逻辑
  • 快速土办法:dump/halt + echo 埋点,适合小问题快速定位
  • 命令行脚本:用 php think 命令行入口跑脚本调试,不经过 Web 层更干净

七、综合小实例:排查页面加载慢

把计时、SQL 监听、变量调试串成一个性能排查套路:

use thinkfacadeDb;
use thinkfacadeDebug;

Debug::remark('start');                      // 1. 开始计时

Db::listen(function ($sql, $runtime) {       // 2. SQL 监听抓慢查询
    if ($runtime > 50) {
        dump('慢SQL: ' . $sql . ' ' . $runtime . 'ms');
    }
});

$list = Db::name('article')                   // 3. 业务代码
    ->where('isshow', 1)
    ->select();

Debug::remark('end');
dump(Debug::getRangeTime('start', 'end') . 's');  // 4. 输出总耗时

再开 app_trace 看页面 Trace 总览(耗时/内存/SQL 条数):SQL 条数异常多是 N+1,单条耗时高是缺索引,总耗时高但 SQL 快则是 PHP 逻辑瓶颈 —— 对症下药。

八、总结

app_debug 开详情、app_trace 看总览;dump/halt 查变量;Db::listen 盯 SQL、阈值记慢查询;Debug::remark 计时找瓶颈;复杂问题上 Xdebug 断点。调试手段组合用,定位问题最快。

顺,不妄喜;逆,不惶馁;安,不奢逸;危,不惊惧。--史记

评论交流

0 条评论 · 支持多级回复
验证码
暂无评论,来说说你的想法吧

相关文章

继续阅读