内容简介:Laravel 默认已经为我们配置好了错误和异常处理,我们在注:关于 Laravel 异常处理底层原理和实现可以参考学院的这篇教程了解更多 ——配置文件
简介
Laravel 默认已经为我们配置好了错误和异常处理,我们在 App\Exceptions\Handler
类中触发异常并将响应返回给用户。在本文档中我们将深入探讨这个类。
注:关于 Laravel 异常处理底层原理和实现可以参考学院的这篇教程了解更多 —— 《深入探讨 PHP 错误异常处理机制及 Laravel 框架底层的相应实现》
配置
配置文件 config/app.php
中的 debug
配置项控制浏览器显示的错误信息数量。默认情况下,该配置项通过 .env
文件中的环境变量 APP_DEBUG
进行设置。
对本地开发而言,你应该设置环境变量 APP_DEBUG
值为 true
。在生产环境,该值应该被设置为 false
。如果在生产环境被设置为 true
,就有可能将一些敏感的配置值暴露给终端用户。
异常处理器
所有异常都由类 App\Exceptions\Handler
处理,该类包含两个方法: report
和 render
。下面我们详细阐述这两个方法。
report 方法
report
方法用于记录异常并将其发送给外部服务如 Bugsnag
或 Sentry
,默认情况下, report
方法只是将异常传递给异常被记录的基类,当然你也可以按自己的需要记录异常并进行相关处理。
例如,如果你需要以不同方式报告不同类型的异常,可使用 PHP 的 instanceof
比较操作符:
/** * 报告或记录异常 * * This is a great spot to send exceptions to Sentry, Bugsnag, etc. * * @param \Exception $e * @return void * @translator laravelacademy.org */ public function report(Exception $e){ if ($e instanceof CustomException) { // } return parent::report($e); }
注:可以考虑使用可报告的异常来取代在 reports
方法中进行大量的 instanceof
检查。
report
辅助函数
有时候你可能需要报告一个异常并继续处理当前请求。辅助函数 report
允许你使用异常处理器的 report
方法快速报告一个异常而不会渲染错误页:
public function isValid($value) { try { // Validate the value... } catch (Exception $e) { report($e); return false; } }
通过类型忽略异常
异常处理器的 $dontReport
属性包含一个不会被记录的异常类型数组,默认情况下,404 错误异常不会被写到日志文件,如果需要的话你可以添加其他异常类型到这个数组:
/** * 不应该被报告的异常类型列表. * * @var array */ protected $dontReport = [ \Illuminate\Auth\AuthenticationException::class, \Illuminate\Auth\Access\AuthorizationException::class, \Symfony\Component\HttpKernel\Exception\HttpException::class, \Illuminate\Database\Eloquent\ModelNotFoundException::class, \Illuminate\Validation\ValidationException::class, ];
render 方法
render
方法负责将给定异常转化为发送给浏览器的 HTTP 响应,默认情况下,异常被传递给为你生成响应的基类。当然,你也可以按照自己的需要检查异常类型或者返回自定义响应:
/** * 将异常渲染到HTTP响应中 * * @param \Illuminate\Http\Request $request * @param \Exception $exception * @return \Illuminate\Http\Response */ public function render($request, Exception $exception){ if ($e instanceof CustomException) { return response()->view('errors.custom', [], 500); } return parent::render($request, $exception); }
可报告 & 可渲染的异常
除了在异常处理器的 report
和 render
方法中进行异常类型检查外,还可以在自定义异常中直接定义 report
和 render
方法。当异常中存在这些方法时,框架会自动调用它们:
<?php namespace App\Exceptions; use Exception; class RenderException extends Exception { /** * Report the exception. * * @return void */ public function report() { // } /** * Render the exception into an HTTP response. * * @param \Illuminate\Http\Request * @return \Illuminate\Http\Response */ public function render($request) { return response(...); } }
HTTP 异常
有些异常描述来自服务器的 HTTP 错误码,例如,这可能是一个“页面未找到”错误(404),“认证失败错误”(401)亦或是程序出错造成的 500 错误,为了在应用中生成这样的响应,可以使用 abort
辅助函数:
abort(404);
abort
辅助函数会立即引发一个会被异常处理器渲染的异常,此外,你还可以像这样提供响应描述:
abort(403, '未授权操作');
该方法可在请求生命周期的任何时间点使用。
自定义 HTTP 错误页面
在 Laravel 中,返回不同 HTTP 状态码的错误页面很简单,例如,如果你想要自定义 404 错误页面,创建一个 resources/views/errors/404.blade.php
文件,该视图文件用于渲染程序返回的所有 404 错误。需要注意的是,该目录下的视图命名应该和相应的 HTTP 状态码相匹配。 abort
函数触发的 HttpException
异常会以 $exception
变量的方式传递给视图:
<h2>{{ $exception->getMessage() }}</h2>
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:- Golang学习笔记之错误处理error、panic (抛出错误),recover(捕获错误)
- c – 构建PBRT v2错误 – 错误1错误U1077:’if’:返回代码’0x1′
- !错误!在 Android 下这么用 ShowModal 是错误的!
- Google开源ClusterFuzz:使得查找错误并修复错误变得异常简单
- 脚本错误量极致优化-定位压缩且无 SourceMap 文件的脚本错误
- php – 解析错误:语法错误,意外’未设置'(T_UNSET)
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
C程序设计语言
(美)Brian W. Kernighan、(美)Dennis M. Ritchie / 徐宝文、李志译、尤晋元审校 / 机械工业出版社 / 2004-1 / 30.00元
在计算机发展的历史上,没有哪一种程序设计语言像C语言这样应用广泛。本书原著即为C语言的设计者之一Dennis M.Ritchie和著名计算机科学家Brian W.Kernighan合著的一本介绍C语言的权威经典著作。我们现在见到的大量论述C语言程序设计的教材和专著均以此书为蓝本。原著第1版中介绍的C语言成为后来广泛使用的C语言版本——标准C的基础。人们熟知的“hello,World"程序就是由本书......一起来看看 《C程序设计语言》 这本书的介绍吧!