一文详解Laravel中怎么进行异常处理

发布时间 - 2022-10-02 00:00:00    点击率:

在本文中,我们将探讨 Laravel Web 框架中最重要和最少讨论的功能之一 - 异常处理。 Laravel 带有一个内置的异常处理程序,可以让您轻松地以友好的方式报告和呈现异常。

在文章的前半部分,我们将探讨异常处理程序提供的默认设置。 事实上,我们首先会通过默认的 Handler 类来理解 Laravel 是如何处理异常的。

在文章的后半部分,我们将继续介绍如何创建自定义异常处理程序,以便您可以捕获自定义异常。

基本配置

在开始研究异常处理类之前,让我们先来看看几个和异常相关且很重要的参数配置。

打开 config/app.php 文件,并仔细的看看下面的代码片段。

...
...
/*
|--------------------------------------------------------------------------
| 应用的调试模式
|--------------------------------------------------------------------------
|
| 当引用处于调试模式,将会显示错误产生式的详细堆栈信息
| 如果禁用,则只显示一个简单的错误页面
|
*/

'debug' => env('APP_DEBUG', false),
...
...

从参数的名称可以猜到,如果设置为 TRUE,将有利于我们调试应用产生的错误。默认值由 .env 环境变量配置文件中的  APP_DEBUG 参数指定。

在开发环境下,建议你将它设置为 TRUE ,这样,通过清晰的错误堆栈信息,能很快的定位错误产生的原因并修复。 另外,当处于正式环境是,我们需要通过环境变量的配置项来关闭它,当错误产生式将只显示通用的提示页面。

除了将错误显示在页面上,Laravel 也允许你将错误记录到日志文件中。现在,让我们来看看日志相关的配置,打开 config/app.php 文件,并仔细的看看下面的代码片段。

...
...
'log' => env('APP_LOG', 'single'),

'log_level' => env('APP_LOG_LEVEL', 'debug'),
...
...

Laravel 框架中,是使用 Monolog 库来记录日志的。你可以通过上面的配置项来配置 Monolog 库。

默认的日志文件保存路径为 storage/logs/laravel.log,通常情况下,你无需更改它。与此同时,你可以通过  APP_LOG_LEVEL 来指定需要被记录到日志文件的错误级别。

前面介绍了异常和日志的基本配置。

接下来,我们看看 Laravel 应用默认的异常处理类。打开 app/Exceptions/Handler.php 文件.

expectsJson()) {
            return response()->json(['error' => 'Unauthenticated.'], 401);
        }

        return redirect()->guest(route('login'));
    }
}

上面的处理类主要包含2个功能:报告和显示所有的异常信息。

让我们仔细看一眼 report 方法。

/**
 * 报告或记录一个异常。
 *
 * 这是一个将异常发送给 Sentry 和 Bugsnag 等机构的好时机。
 *
 * @param  \Exception  $exception
 * @return void
 */
public function report(Exception $exception)
{
    parent::report($exception);
}

report 方法用于将错误记录到日志文件中。同时,关注一项重要的 dontReport 属性,它列出了所有不应该被记录到日志的异常类别。

接下来,我们介绍 render 方法。

/**
 * 将异常渲染至 HTTP 响应值中。
 *
 * @param  \Illuminate\Http\Request  $request
 * @param  \Exception  $exception
 * @return \Illuminate\Http\Response
 */
public function render($request, Exception $exception)
{
    return parent::render($request, $exception);
}

如果说 report 方法是用于记录或报告错误,那么 render 方法是用于将错误渲染显示在屏幕上。事实上,当异常发生时,这个方法决定了哪些内容将被展示给用户。

render 方法也允许你针对不同类别的错误自定义响应值,这部分内容我们将在下一章学习。

最后, unauthenticated 方法处理了 AuthenticationException 异常,你能够在此决定当用户访问了一个未授权页面时所展示的内容。

自定义异常类

在这一节,我们将创建一个自定义异常类,用于处理 CustomException 类别的异常。创建自定义异常类背后的想法是更轻松地管理自定义异常同时显示自定义响应。

开始着手创建一个文件 app/Exceptions/CustomException.php ,内容如下所示。

view(
                'errors.custom',
                array(
                    'exception' => $this
                )
        );
    }
}

重要的是需要注意 CustomException 类必须继承核心 Exception 类。为了演示用途,我们仅仅讨论了 render 方法,但显然你也能够自定义修改 report 方法。

正如你看到的,在样例中我们将用户重定向至 errors.custom 错误页面。通过这种方式,你能够为特定类型的异常实现自定义的错误页面。

当然,我们需要创建一个关联的视图文件 resources/views/errors/custom.blade.php

Exception details: {{ $exception->getMessage() }}

这是一个相当简单的视图文件,只显示一行错误消息,不过你也可以按照自己希望的方式设计这个视图。

我们也需要在 app/Exceptions/Handler.php 文件的 render 方法中进行一些修改,保证我们的自定义异常类能够被调用。让我们将 app/Exceptions/Handler.php 文件中的 render 方法替换为以下内容。

...
...
/**
 * 将异常渲染至 HTTP 响应值中。
 *
 * @param  \Illuminate\Http\Request  $request
 * @param  \Exception  $exception
 * @return \Illuminate\Http\Response
 */
public function render($request, Exception $exception)
{
    if ($exception instanceof \App\Exceptions\CustomException)  {
        return $exception->render($request);
    }

    return parent::render($request, $exception);
}
...
...

正如你所看到的,我们会在 render 方法中首先检查异常的类型。如果异常的类别是 \App\Exceptions\CustomException ,我们将调用这个类的 render 方法。

一切准备就绪。现在我们创建一个控制  app/Http/Controllers/ExceptionController.php  来测试自定义的异常类。

nction index()
    {
        // 出错了,你可以抛出自定义的异常 CustomException
        throw new \App\Exceptions\CustomException('Something Went Wrong.');
    }
}

当然,你需要先在 routes/web.php 文件中添加相关的路由,就像下面一样。

// Exception routes
Route::get('exception/index', 'ExceptionController@index');

之后,你可以浏览 http://your-laravel-site.com/exception/ind... 地址来查看是否和预期的一样。一切正常的话,页面将显示我们前面配置 errors.custom 视图。

就这样,你就可以按自己方式来处理 Laravel 中的异常。
完!尽情享受 Laravel 带来的编码的乐趣吧!

总结

今天,我们认真学习了 Laravel 中的异常处理特性。在文章的开头,我们搜索了 Laravel 提供的一些基础配置,用于显示和报告异常。紧接着,我们简要介绍了默认的异常处理类。

在文章的后半部分,我们通过创建一个自定义异常处理类,演示如何在应用中处理自定义的异常。

对于那些刚刚起步学习 Laravel ,或者期待拓展阅读相关知识、网站、应用扩展的读者,这里有一系列您能够学习的内容,参见 Envato Market 。

期待听到任何形式的咨询或建议!

原文地址:https://code.tutsplus.com/tutorials/exception-handling-in-laravel--cms-30210译文地址:https://learnku.com/laravel/t/8783/exception-handling-in-laravel

【相关推荐:laravel视频教程】


# php  # laravel  # 继承  #   #   # http  # https  # cms  # 自定义  # 让我们  # 创建一个  # 你可以  # 只显示  # 这是一个  # 设置为  # 基本配置  # 的是  # 后半部 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: linux top下的 minerd 木马清除方法  Laravel DB事务怎么使用_Laravel数据库事务回滚操作  微博html5版本怎么弄发语音微博_语音录制入口及时长限制操作【教程】  JS碰撞运动实现方法详解  php 三元运算符实例详细介绍  怎样使用JSON进行数据交换_它有什么限制  Linux虚拟化技术教程_KVMQEMU虚拟机安装与调优  Laravel安装步骤详细教程_Laravel环境搭建指南  SQL查询语句优化的实用方法总结  如何用AWS免费套餐快速搭建高效网站?  Swift开发中switch语句值绑定模式  如何有效防御Web建站篡改攻击?  如何快速建站并高效导出源代码?  Laravel怎么实现搜索功能_Laravel使用Eloquent实现模糊查询与多条件搜索【实例】  使用C语言编写圣诞表白程序  如何基于云服务器快速搭建网站及云盘系统?  重庆市网站制作公司,重庆招聘网站哪个好?  瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口  Laravel怎么判断请求类型_Laravel Request isMethod用法  laravel怎么实现图片的压缩和裁剪_laravel图片压缩与裁剪方法  微信小程序 HTTPS报错整理常见问题及解决方案  如何为不同团队 ID 动态生成多个“认领值班”按钮  MySQL查询结果复制到新表的方法(更新、插入)  Laravel如何发送系统通知?(Notification渠道示例)  小米17系列还有一款新机?主打6.9英寸大直屏和旗舰级影像  Laravel如何实现API资源集合?(Resource Collection教程)  JavaScript 输出显示内容(document.write、alert、innerHTML、console.log)  html文件怎么打开证书错误_https协议的html打开提示不安全【指南】  JavaScript中如何操作剪贴板_ClipboardAPI怎么用  免费视频制作网站,更新又快又好的免费电影网站?  Laravel怎么实现模型属性的自动加密  韩国代理服务器如何选?解析IP设置技巧与跨境访问优化指南  CSS3怎么给轮播图加过渡动画_transition加transform实现【技巧】  Laravel集合Collection怎么用_Laravel集合常用函数详解  如何在IIS中新建站点并配置端口与IP地址?  高防服务器租用如何选择配置与防御等级?  创业网站制作流程,创业网站可靠吗?  高端云建站费用究竟需要多少预算?  Laravel辅助函数有哪些_Laravel Helpers常用助手函数大全  Laravel怎么多语言本地化设置_Laravel语言包翻译与Locale动态切换【手册】  米侠浏览器网页背景异常怎么办 米侠显示修复  Win11怎么关闭资讯和兴趣_Windows11任务栏设置隐藏小组件  高防网站服务器:DDoS防御与BGP线路的AI智能防护方案  如何快速生成高效建站系统源代码?  Laravel如何创建自定义Facades?(详细步骤)  C#如何调用原生C++ COM对象详解  Win11应用商店下载慢怎么办 Win11更改DNS提速下载【修复】  宙斯浏览器怎么屏蔽图片浏览 节省手机流量使用设置方法  Python进程池调度策略_任务分发说明【指导】  为什么要用作用域操作符_php中访问类常量与静态属性的优势【解答】