centos上laravel如何调试

在 CentOS 上调试 Laravel，通常可以从 日志、调试工具、PHP 配置、开发环境 几个方面入手。下面给你一套常用且实用的方案。

一、最基础：打开错误显示（开发环境）

1. 修改 .env

APP_ENV=local
APP_DEBUG=true

⚠️ 生产环境 不要 开 APP_DEBUG=true

2. 检查 PHP 错误显示

编辑 php.ini（位置通常是 /etc/php.ini 或 /etc/php.d/）

display_errors = On
error_reporting = E_ALL

重启 PHP：

systemctl restart php-fpm
# 或
systemctl restart httpd

二、查看 Laravel 日志（最常用）

1. 查看日志文件

tail -f storage/logs/laravel.log

2. 手动写日志调试

\Log::info('测试数据', ['data' => $data]);
\Log::error('出错了', ['msg' => $e->getMessage()]);

三、使用 dump / dd 调试

1. 输出并继续

dump($user);

2. 输出并终止

dd($request->all());

四、使用 Laravel Debugbar（推荐）

安装

composer require barryvdh/laravel-debugbar --dev

发布配置

php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"

浏览器访问页面即可看到：

• SQL
• 请求
• 视图
• 日志

五、Artisan 命令调试

查看路由

php artisan route:list

清理缓存（很重要）

php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear

调试 Artisan 命令

php artisan tinker

User::first();

六、Xdebug（高级断点调试）

1. 安装 Xdebug（CentOS）

yum install php-xdebug

2. 配置 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. 用 PHPStorm / VS Code 远程调试

适合：

• 复杂逻辑
• API 调试
• 第三方包问题

七、常见 CentOS 特有坑

1. 权限问题

chmod -R 755 storage bootstrap/cache
chown -R nginx:nginx storage

2. SELinux

setenforce 0

（生产不建议长期关闭）

八、推荐调试组合（新手友好）

✅ APP_DEBUG=true
✅ tail -f storage/logs/laravel.log
✅ dd() / dump()
✅ Laravel Debugbar

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

• CentOS 版本（7 / 8 / Stream）
• PHP 版本
• 用的是 Nginx 还是 Apache
• 是 Web 请求还是 Artisan 命令调试

我可以直接给你针对性的调试配置。