温馨提示×

laravel在centos怎调试

小樊
38
2026-10-23 09:21:10
栏目: 智能运维

在 CentOS 上调试 Laravel,通常可以从 日志、错误显示、调试工具、运行环境 几个方面入手。下面按实用程度给你一套完整方案。


一、先确认基础环境

php -v
composer -V
php artisan --version

确保:

  • PHP 版本满足 Laravel 要求
  • 已安装必要扩展(如 mbstring, openssl, pdo, tokenizer 等)

二、开启错误显示(开发环境)

1️⃣ 修改 .env

APP_ENV=local
APP_DEBUG=true

2️⃣ 清除配置缓存

php artisan config:clear
php artisan cache:clear

三、查看 Laravel 日志(最重要)

tail -f storage/logs/laravel.log

常见错误:

  • 权限问题
  • SQL 错误
  • 路由/中间件错误

四、权限问题(CentOS 常见坑)

Laravel 需要写权限:

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

或(php-fpm 用户)

chown -R apache:apache storage bootstrap/cache

五、使用 Laravel 自带调试工具

1️⃣ dd() / dump()

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

2️⃣ Laravel Telescope(强烈推荐)

composer require laravel/telescope
php artisan telescope:install
php artisan migrate

访问:

http://your-domain/telescope

六、SQL 调试

1️⃣ 监听 SQL

\DB::listen(function ($query) {
    logger($query->sql, $query->bindings);
});

2️⃣ 打印 SQL

User::toSql();

七、Web 服务器调试(Nginx / Apache)

Nginx 错误日志

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

PHP-FPM 日志

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

八、Xdebug(高级调试)

1️⃣ 安装

yum install php-xdebug

2️⃣ 配置

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

配合 PHPStorm + Xdebug 可断点调试。


九、常见 CentOS 问题速查

问题 解决
500 错误 看 laravel.log
空白页 APP_DEBUG=true
权限拒绝 chmod storage
SELinux 阻止 setenforce 0 测试

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

  • Laravel 版本
  • CentOS 版本
  • Web 服务器(Nginx / Apache)
  • 具体报错信息

我可以帮你精准定位问题。

0 踩