Laravel在Debian咋调试

在 Debian 上调试 Laravel，常见且实用的方法有下面几类，按「从快到专业」给你梳理一下。

一、最基础的：开启调试模式

1. 修改 .env

APP_DEBUG=true
APP_ENV=local

然后清缓存：

php artisan config:clear
php artisan cache:clear

这样页面出错会显示详细错误。

二、查看日志（最常用）

Laravel 日志在：

storage/logs/laravel.log

实时查看：

tail -f storage/logs/laravel.log

也可以自己写日志调试：

\Log::info('测试数据', ['data' => $data]);

三、使用 Laravel 自带调试函数

dd($var);        // 打印并终止
dump($var);      // 打印不终止

四、命令行调试（Artisan + Tinker）

1. 路由是否正常

php artisan route:list

2. 数据库调试

php artisan tinker

User::first();

3. 查看配置

php artisan config:show

五、Xdebug（Debian 专业调试）

1. 安装 Xdebug

sudo apt update
sudo apt install php-xdebug

2. 配置（示例 PHP 8.2）

编辑：

/etc/php/8.2/cli/php.ini
# 或 fpm 配置（web 调试）
/etc/php/8.2/fpm/conf.d/20-xdebug.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 php8.2-fpm

3. 用 VS Code / PHPStorm 打断点

• 安装 PHP Debug 插件
• 配置 launch.json
• 浏览器访问触发断点

✅ 适合复杂逻辑、循环、API 调试

六、Web 调试工具（推荐）

Laravel Debugbar

composer require barryvdh/laravel-debugbar --dev

浏览器右下角会出现调试面板（SQL、请求、视图等）

七、常见问题排查

PHP 版本不对

php -v

权限问题（Debian 常见）

sudo chown -R www-data:www-data storage bootstrap/cache
chmod -R 775 storage

Nginx / Apache 不解析

sudo systemctl status nginx
sudo systemctl status php8.2-fpm

总结（推荐组合）

✅ 日常：
APP_DEBUG=true + tail -f laravel.log + dd()

✅ 进阶：
Laravel Debugbar

✅ 专业：
Xdebug + VS Code

如果你告诉我：

• 是 CLI 还是 Web
• 用的是 Nginx / Apache
• PHP 版本

我可以给你一份完全贴合你服务器的调试配置。