温馨提示×

centos中laravel怎么调试

小樊
44
2026-09-24 02:56:09
栏目: 智能运维

在 CentOS 上调试 Laravel,常见方式分为 日志调试、断点调试(Xdebug)、命令行调试、环境配置 几类。下面给你一套实用方案(从简单到专业)。


一、最常用:日志 & dd() 调试(无需额外工具)

1️⃣ 使用 dd() / dump()

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

dd() 会终止程序并输出
dump() 不终止

2️⃣ 写入日志

\Log::info('调试信息', [
    'data' => $data
]);

查看日志:

tail -f storage/logs/laravel.log

二、开启 Laravel 调试模式(很重要)

编辑 .env

APP_DEBUG=true
APP_ENV=local

然后:

php artisan config:clear

✅ 出错时会显示详细错误页面


三、命令行调试(Artisan / Tinker)

1️⃣ Tinker(强烈推荐)

php artisan tinker
User::find(1);

适合调试模型、查询、逻辑错误。


2️⃣ 调试 SQL

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

四、Xdebug 断点调试(CentOS + PHPStorm / VSCode)

1️⃣ 安装 Xdebug(CentOS)

yum install php-xdebug
# 或
pecl install xdebug

查看是否安装成功:

php -m | grep xdebug

2️⃣ 配置 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
xdebug.idekey=PHPSTORM

重启 PHP:

systemctl restart php-fpm
# 或
systemctl restart httpd

3️⃣ PHPStorm 配置

  • Settings → PHP → Debug
  • 端口:9003
  • 开启 Start Listening for PHP Debug Connections
  • 浏览器安装 Xdebug Helper

✅ 可断点、单步执行、查看变量


五、性能 & 错误调试工具(推荐)

Laravel Debugbar

composer require barryvdh/laravel-debugbar --dev

页面底部会显示:

  • SQL
  • 请求
  • 视图
  • 日志

六、常见 CentOS 特殊问题

1️⃣ 权限问题导致日志不写入

chown -R nginx:nginx storage
chmod -R 775 storage

2️⃣ SELinux 阻止

setenforce 0
# 或
ausearch -m avc -ts recent

七、调试流程建议(实战)

✅ 小问题:dd() + Log
✅ SQL 问题:DB::enableQueryLog()
✅ 逻辑问题:tinker
✅ 复杂业务:Xdebug


如果你愿意,可以告诉我:

  • CentOS 版本(7 / 8 / Stream)
  • PHP 版本
  • 用的是 Nginx 还是 Apache
  • 是否用 PHPStorm / VSCode

我可以直接给你可复制的配置方案。

0 踩