linux thinkphp如何调试

在 Linux 下调试 ThinkPHP，常见方式有以下几种，按“从简单到专业”给你整理：

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

1️⃣ 开启调试模式

编辑项目根目录的 .env 文件（没有就新建）：

APP_DEBUG = true

或 config/app.php：

'app_debug' => true,

开启后：

• 报错会显示完整堆栈
• 页面下方会出现 Trace 调试信息

二、查看日志（生产环境也常用）

2️⃣ 查看日志文件

日志路径一般是：

runtime/log/

查看最新日志：

tail -f runtime/log/*/*.log

常见日志级别：

• error
• sql
• info

三、使用 dump / var_dump / trace

3️⃣ ThinkPHP 推荐调试函数

dump($data);

或：

halt($data); // 输出并终止

四、SQL 调试（非常重要）

4️⃣ 打印 SQL

Db::name('user')->fetchSql(true)->select();

或监听 SQL：

Db::listen(function ($sql, $time, $explain) {
    echo $sql . ' [' . $time . 's]';
});

五、使用 Xdebug（专业级调试）

5️⃣ Linux + PHP + Xdebug

安装 Xdebug

pecl install xdebug

或在 Ubuntu：

sudo apt install php-xdebug

配置 php.ini

[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

重启 PHP：

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

配合 IDE

• VS Code（Xdebug 插件）
• PHPStorm（断点调试）

六、命令行调试（CLI）

php think run

或执行脚本：

php think your:command

调试输出：

echo、dump、var_dump

七、常见问题排查

✅ 页面空白

• 查看 runtime/log
• 检查 APP_DEBUG

✅ 权限问题

chmod -R 755 runtime
chown -R www:www runtime

八、推荐调试组合（实战）

✅ 开发环境：

• APP_DEBUG = true
• dump() + 日志
• Xdebug 断点

✅ 生产环境：

• 关闭 debug
• 查看 runtime/log

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

• ThinkPHP 版本（5.1 / 6.0 / 8.0）
• 是 Web 调试 还是 命令行
• 用的是 Nginx / Apache / PHP-FPM

我可以直接给你对应环境的完整配置示例。