ubuntu中thinkphp怎样调试

在 Ubuntu 下调试 ThinkPHP（以 ThinkPHP 5 / 6 为主，兼顾 3.2），常见方式如下：

一、开启 ThinkPHP 自带调试模式

1. 开启调试（关键）

ThinkPHP 5 / 6

修改项目根目录的 .env（没有就新建）：

APP_DEBUG = true

或 config/app.php：

'app_debug' => true,

ThinkPHP 3.2

修改 Application/Common/Conf/config.php：

'APP_DEBUG' => true,

二、查看错误信息

开启调试后：

• 页面会直接显示 错误信息 + 堆栈
• 错误日志在：
  • TP5/6：runtime/log/
  • TP3：Application/Runtime/Logs/

查看日志：

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

三、使用 ThinkPHP 调试函数

1. dump()（推荐）

dump($data);

2. halt()（输出并终止）

halt($data);

3. 原生调试

echo '<pre>';
print_r($data);
exit;

四、Ubuntu 下 PHP 环境调试

1. 查看 PHP 错误显示

编辑 php.ini（位置通常在）：

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

确保：

display_errors = On
error_reporting = E_ALL

重启：

sudo systemctl restart php8.1-fpm

五、使用 Xdebug（强烈推荐）

1. 安装 Xdebug

sudo apt install php-xdebug

2. 配置 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：

sudo systemctl restart php8.1-fpm

3. 配合编辑器

• VS Code：安装 PHP Debug
• PHPStorm：配置 Xdebug

六、命令行调试（CLI）

php think run
# 或
php think serve

查看报错：

php think your:command

七、常见问题排查

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

• ThinkPHP 版本（3.2 / 5.0 / 5.1 / 6.0）
• Ubuntu 版本
• 用 Apache 还是 Nginx
• 是否用 Docker

我可以给你更精确的调试配置。