ThinkPHP如何进行代码调试

ThinkPHP代码调试实用指南

开启调试模式与查看错误

开发环境建议开启调试模式，以便显示详细错误信息与页面 Trace。不同版本开启方式略有差异：
- ThinkPHP 5.x：在入口文件 public/index.php 定义常量
```
define('APP_DEBUG', true);
```
- ThinkPHP 6.x：在应用配置 config/app.php 中设置
```
'app_debug' => true,
```
调试模式通常会带来以下便利：开启日志记录、关闭模板缓存、记录SQL日志、关闭字段缓存、更严格的大小写检查，并在页面底部输出Trace 信息（运行时间、内存、加载时间、请求协议等）。
页面无输出或空白时，优先查看框架运行日志文件：runtime/log/ 目录下的日志，可快速定位错误来源。
注意：切勿在生产环境开启调试模式，以免泄露敏感信息。

内置输出与日志定位

使用框架提供的 dump() 输出变量，比 var_dump 更友好地展示复杂结构：
```
use think\facade\Debug;
Debug::dump($data);
```

查看最近一次执行的 SQL：

// 执行查询或操作...
echo Db::getLastSql();

记录自定义错误与关键流程日志：

use think\facade\Log;
Log::error('支付回调失败：' . $e->getMessage());

结合 页面 Trace 与 SQL 日志，可直观看到执行流程与每条 SQL 的耗时，便于发现慢查询与异常调用。

性能与 SQL 跟踪

快速统计代码段执行时间与内存开销（适用于 ThinkPHP 3.x/5.x 等内置 G 方法的版本）：

G('start');
// ... 需要统计的代码段 ...
G('stop');
echo G('start', 'stop', 4); // 输出：0.0030（秒，保留4位小数）

若版本未内置 G 方法，可用 microtime(true) 自行计算耗时：

$t0 = microtime(true);
// ... 代码段 ...
echo microtime(true) - $t0;

结合 SQL 日志 与 getLastSql()，定位慢 SQL、重复查询与错误条件，必要时为关键表添加索引或优化查询。

使用 Xdebug 进行断点调试

安装并启用 Xdebug（示例为 php.ini 配置，按系统与 PHP 版本调整扩展名与路径）：

[xdebug]
zend_extension=xdebug.so        ; Windows 可能为 xdebug.dll
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

IDE 配置（以 PHPStorm 为例）：
- 打开 Settings > PHP > Debug，确认 Debug port 为 9003（与 php.ini 一致）。
- 新建 PHP Remote Debug 配置，设置服务器与本机映射，保存后点击 Start Listening for PHP Debug Connections。
调试流程：在控制器或模型代码处设置断点 → 以 debug 方式访问对应 URL（或在 CLI 调试）→ 命中断点后查看变量、调用栈并单步执行。

命令行调试示例：

php -dxdebug.mode=debug -dxdebug.start_with_request=yes your_script.php

通过 Xdebug 可高效排查复杂逻辑、异常流程与难以复现的问题。

常见问题快速排查清单

404 控制器或方法不存在：核对 URL 路由与控制器/方法名是否一致，检查命名空间与文件位置。
数据库连接失败：检查 database.php 中的 host、database、username、password、port 与访问权限。
语法错误：关注报错文件的行号与语法提示，优先修复语法问题后再运行。
模板错误：检查模板语法、变量是否定义、标签闭合与缓存是否影响。
页面空白或无输出：查看 runtime/log/ 下的最新日志，定位异常发生点。
AJAX 请求看不到 SQL：除页面 Trace 外，开启或查阅 SQL 日志，并使用 getLastSql() 复核实际执行的语句。