thinkphp在ubuntu怎样调试

在 Ubuntu 上调试 ThinkPHP（以 ThinkPHP 5 / 6 / 8 常见情况为例），通常可以从 日志、调试模式、Xdebug、命令行 几个方面入手。下面按“从简单到专业”的方式说明。

一、开启 ThinkPHP 调试模式（最常用）

1. 开启调试模式

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

APP_DEBUG=true

如果是 ThinkPHP 5 老版本，也可能在 application/config.php：

'app_debug' => true,

开启后：

• 页面报错会显示详细堆栈
• 命令行会输出调试信息

2. 查看日志

日志位置：

runtime/log/

查看最新日志：

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

在代码中记录日志：

\think\facade\Log::error('调试信息');
\think\facade\Log::info('变量', $data);

二、使用 dump / var_dump 调试

1. 浏览器调试

dump($data);

或：

var_dump($data);
exit;

2. 命令行调试

php think run

或执行命令：

php think your:command

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

1. 安装 Xdebug

sudo apt update
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

重启服务：

sudo systemctl restart php8.1-fpm
sudo systemctl restart nginx

3. 使用 VS Code 调试

安装插件：PHP Debug

.vscode/launch.json：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003
    }
  ]
}

然后：

• 打断点
• 浏览器访问页面
• VS Code 自动停在断点

四、常见调试技巧

1. 路由调试

php think route:list

2. 数据库调试

Db::getLastSql();

或开启 SQL 日志：

'debug' => true

3. 捕获异常

try {
    // code
} catch (\Exception $e) {
    echo $e->getMessage();
}

五、推荐组合方案

✅ 新手

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

✅ 进阶

• Xdebug + VS Code
• 命令行 + 日志

如果你告诉我：

• ThinkPHP 版本（5 / 6 / 8）
• 是 Web 还是 CLI
• 用的是 Nginx 还是 Apache

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