centos怎样调试laravel

在 CentOS 上调试 Laravel，通常可以从 日志、错误显示、调试工具、运行环境 几个方面入手。下面按「最常用 → 进阶」的顺序说明。

一、基础调试方法（必看）

1. 打开错误显示（开发环境）

编辑 .env：

APP_ENV=local
APP_DEBUG=true

然后清缓存：

php artisan config:clear
php artisan cache:clear

⚠️ 生产环境一定要 APP_DEBUG=false

2. 查看 Laravel 日志

tail -f storage/logs/laravel.log

常见错误：

• SQL 错误
• 路由不存在
• 权限问题

3. 使用 dd() / dump()

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

二、Web 服务器相关（CentOS 常见坑）

1. 权限问题（非常常见）

chown -R nginx:nginx /var/www/laravel
chmod -R 755 /var/www/laravel
chmod -R 777 storage bootstrap/cache

nginx 或 apache 用户需可写 storage

2. PHP 错误日志

tail -f /var/log/php-fpm/error.log

或 Apache：

tail -f /var/log/httpd/error_log

3. 查看 PHP 版本 & 扩展

php -v
php -m | grep -E "mbstring|openssl|pdo|tokenizer"

Laravel 必需扩展：

• PHP ≥ 8.1（看你 Laravel 版本）
• mbstring
• openssl
• pdo
• tokenizer
• xml

三、数据库调试

1. 打印 SQL

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

或使用：

\Log::info(DB::getQueryLog());

2. 测试数据库连接

php artisan tinker
DB::connection()->getPdo();

四、路由 & 控制器调试

1. 查看路由

php artisan route:list

2. 测试路由

php artisan serve

然后访问：

http://localhost:8000/your-route

五、进阶调试（推荐）

1. 使用 Xdebug（CentOS）

安装：

yum install php-xdebug

配置 /etc/php.d/xdebug.ini：

zend_extension=xdebug
xdebug.mode=debug
xdebug.start_with_request=yes

配合 PHPStorm + Xdebug 可断点调试。

2. Laravel Debugbar（强烈推荐）

composer require barryvdh/laravel-debugbar --dev

访问页面即可看到：

• SQL
• 路由
• 视图
• 请求数据

六、常见 CentOS + Laravel 错误速查

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

• CentOS 版本（7 / 8 / Stream）
• Web 服务（Nginx / Apache）
• Laravel 版本
• 具体报错信息

我可以给你 更精确的调试方案。