怎样用Debian调试Laravel程序

在 Debian 上调试 Laravel 程序，通常可以从**环境准备、日志与错误显示、调试工具、IDE 调试（Xdebug）**几个方面入手。下面给你一套实用流程。

一、基础环境准备（Debian）

1. 安装必要组件

sudo apt update
sudo apt install -y php php-cli php-fpm php-mysql php-mbstring php-xml php-curl php-zip unzip git nginx

2. 安装 Composer

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

3. 确认 PHP 版本

php -v

Laravel 不同版本对 PHP 有要求（如 Laravel 10 需要 PHP 8.1+）。

二、开启 Laravel 错误显示

1. 修改 .env

APP_DEBUG=true
APP_ENV=local

2. 清除配置缓存

php artisan config:clear
php artisan cache:clear

三、查看日志（最常用）

1. Laravel 日志

tail -f storage/logs/laravel.log

2. PHP / Nginx 错误日志

# PHP-FPM
tail -f /var/log/php*-fpm.log

# Nginx
tail -f /var/log/nginx/error.log

四、使用 Laravel 自带调试工具

1. dump() / dd()

dump($user);
dd($request->all());

2. Artisan 命令调试

php artisan route:list
php artisan tinker
php artisan migrate:status

3. 查看 SQL 日志

\DB::enableQueryLog();
// 执行查询
dump(\DB::getQueryLog());

五、使用 Xdebug（IDE 断点调试，强烈推荐）

1. 安装 Xdebug

sudo apt install php-xdebug

2. 配置 Xdebug（示例）

编辑 php.ini 或 /etc/php/*/cli/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

3. 重启 PHP-FPM

sudo systemctl restart php*-fpm

4. 在 VSCode / PHPStorm 中配置

• 安装 PHP Debug 插件
• 设置 Listen for Xdebug
• 打断点 → 访问页面即可

六、常见调试场景

七、推荐组合（Debian + Laravel）

• Debian + Nginx + PHP-FPM
• Laravel + Xdebug + VSCode
• tail -f storage/logs/laravel.log

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

• 你用的是 Nginx 还是 Apache
• 是否使用 Docker
• 报错信息或具体场景

我可以直接帮你定位问题。