ubuntu thinkphp怎样调试

ubuntu

小樊

2026-09-22 20:49:58

栏目: 编程语言

在 Ubuntu + ThinkPHP 环境下调试，常见、有效的方式有以下几种，按使用频率从高到低给你说明：

一、开启 ThinkPHP 调试模式（最基础）

1️⃣ 开启调试模式

编辑项目根目录的 .env 文件（没有就复制 .env.example）：

APP_DEBUG = true

或 config/app.php：

'app_debug' => true,

开启后：

出错会显示 详细错误页面
显示 SQL、 trace 信息

二、使用 ThinkPHP 自带日志（最常用）

1️⃣ 写日志

\think\facade\Log::info('测试日志');
\think\facade\Log::error('错误信息');

2️⃣ 查看日志

日志在：

runtime/log/

实时查看：

tail -f runtime/log/20260121.log

三、使用 dump / var_dump 快速调试

dump($data);
exit;

或：

var_dump($data);
die;

✅ 适合快速看变量结构

四、打印 SQL 调试（数据库必用）

方式 1：调试模式自动显示

开启 APP_DEBUG=true 后，页面底部会显示 SQL

方式 2：手动获取 SQL

Db::getLastSql();

或：

$list = Db::name('user')->where('id', 1)->select();
echo Db::getLastSql();

五、使用 Xdebug（专业调试，推荐）

1️⃣ 安装 Xdebug

sudo apt install php-xdebug

2️⃣ 配置 php.ini

xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

重启：

sudo systemctl restart php-fpm
# 或
sudo service apache2 restart

3️⃣ 用 IDE 调试

PHPStorm
VS Code（推荐插件：PHP Debug）

✅ 可断点、单步执行、查看变量

六、命令行调试（CLI）

php think run

或执行命令：

php think your:command

七、常见问题排查

1️⃣ 页面空白

检查 runtime 权限

sudo chmod -R 777 runtime

2️⃣ 报错不显示

error_reporting(E_ALL);
ini_set('display_errors', 'on');

总结（推荐组合）

✅ 开发环境：APP_DEBUG=true + Log + dump
✅ 复杂问题：Xdebug
✅ SQL问题：getLastSql()

如果你愿意，可以告诉我：

ThinkPHP 版本（5.1 / 6.0 / 8.0）
用的是 Apache 还是 Nginx
是页面调试还是接口调试

我可以给你更精确的配置示例。