ubuntu thinkphp怎么调试

ubuntu

小樊

2026-10-13 10:16:54

栏目: 编程语言

在 Ubuntu + ThinkPHP 环境下调试，常见做法有下面几种，按「从简单到专业」给你整理：

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

1️⃣ 开启调试模式

修改项目根目录下的 .env 文件（如果没有就复制 .env.example）：

APP_DEBUG = true

或修改 config/app.php：

'app_debug' => true,

开启后：

页面会显示详细错误信息
会显示 SQL、日志、调用栈

二、查看日志（推荐）

ThinkPHP 默认日志在：

runtime/log/

查看最新日志：

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

也可以在 .env 中设置日志级别：

LOG_LEVEL = debug

三、使用 dump / var_dump 调试

在控制器或模型中：

dump($data);
// 或
var_dump($data);
exit;

ThinkPHP 的 dump() 更美观。

四、浏览器调试（Trace）

开启 Trace（开发时很有用）：

.env

APP_TRACE = true

页面右下角会出现：

请求信息
SQL
变量
执行时间

五、Xdebug + PHPStorm / VS Code（专业调试）

1️⃣ 安装 Xdebug

sudo apt install php-xdebug

查看是否安装成功：

php -m | grep xdebug

2️⃣ 配置 Xdebug（Ubuntu）

编辑 php.ini（路径可能不同）：

php --ini

一般路径：

/etc/php/8.1/cli/php.ini
/etc/php/8.1/fpm/php.ini

添加：

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

重启 PHP：

sudo systemctl restart php8.1-fpm

3️⃣ VS Code 调试

安装插件：PHP Debug

launch.json：

{
  "name": "Listen for Xdebug",
  "type": "php",
  "request": "launch",
  "port": 9003
}

打断点 → F5 → 浏览器访问页面

六、常见问题排查

页面空白？

tail -f /var/log/nginx/error.log
# 或
tail -f /var/log/apache2/error.log

权限问题

sudo chmod -R 777 runtime
sudo chown -R www-data:www-data .

七、推荐组合（开发环境）

✅ APP_DEBUG=true
✅ APP_TRACE=true
✅ Xdebug + VS Code
✅ tail -f runtime/log

如果你能告诉我：

ThinkPHP 版本（5.1 / 6.0 / 8.0）
用 Nginx 还是 Apache
是否用 Docker

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