ubuntu中thinkphp如何调试

在 Ubuntu 环境下调试 ThinkPHP（以 ThinkPHP 5 / 6 / 8 为主），通常可以从日志、调试模式、断点调试、浏览器工具几个方面入手。下面按实用顺序说明。

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

1. 开启调试模式

编辑项目根目录的 .env（推荐）或 config/app.php

.env 方式（推荐）

APP_DEBUG = true

config/app.php

'app_debug' => true,

开启后：

• 页面会显示详细错误信息
• 支持 Trace 调试信息
• 日志更详细

二、查看日志（非常重要）

1. 日志位置

runtime/log/

查看最新日志：

tail -f runtime/log/20260121.log

2. 手动写日志

use think\facade\Log;

Log::error('测试错误');
Log::info('调试信息');

三、使用 dump / var_dump

1. ThinkPHP 自带

dump($data);

2. 中断执行

dump($data);
exit;

四、浏览器调试（前端 + 接口）

1. 接口调试

推荐使用：

• Postman
• Apifox
• curl

curl http://localhost/index.php/index/test

2. 浏览器

• F12 → Network
• 查看请求参数、返回值、状态码

五、Xdebug 断点调试（推荐进阶）

1. 安装 Xdebug

sudo apt install php-xdebug

查看是否安装：

php -m | grep xdebug

2. 配置 Xdebug（php.ini）

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

重启服务：

sudo systemctl restart apache2
# 或
sudo systemctl restart php8.1-fpm

3. 编辑器调试

• VS Code
  • 安装 PHP Debug 插件
  • 配置 launch.json
• PHPStorm
  • 配置 PHP → Debug → Xdebug

打断点 → 浏览器访问 → 自动暂停

六、ThinkPHP 自带调试工具

1. Trace

\think\facade\Trace::show();

2. 性能调试

$t1 = microtime(true);
// 代码
$t2 = microtime(true);
echo $t2 - $t1;

七、常见调试场景

1. 路由不生效

php think route:list

2. 控制器未找到

• 检查命名空间
• 检查文件名大小写（Linux 严格区分）

3. 权限问题

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

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

✅ 新手：

• APP_DEBUG = true
• dump()
• runtime/log

✅ 进阶：

• Xdebug + VS Code
• Postman
• 日志 + Trace

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

• ThinkPHP 版本（5 / 6 / 8）
• 用的是 Apache 还是 Nginx
• 是接口调试还是页面调试

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