前言
異常處理是編程中十分重要但也最容易被人忽視的語言特性，它為開發(fā)者提供了處理程序運(yùn)行時錯誤的機(jī)制，對于程序設(shè)計來說正確的異常處理能夠防止泄露程序自身細(xì)節(jié)給用戶，給開發(fā)者提供完整的錯誤回溯堆棧，同時也能提高程序的健壯性。
這篇文章我們來簡單梳理一下Laravel中提供的異常處理能力，然后講一些在開發(fā)中使用異常處理的實(shí)踐，如何使用自定義異常、如何擴(kuò)展Laravel的異常處理能力。
下面話不多說了，來一起看看詳細(xì)的介紹吧
注冊異常Handler
這里又要回到我們說過很多次的Kernel處理請求前的bootstrap階段，在bootstrap階段的Illuminate\Foundation\Bootstrap\HandleExceptions 部分中Laravel設(shè)置了系統(tǒng)異常處理行為并注冊了全局的異常處理器:
class HandleExceptions
{
public function bootstrap(Application $app)
{
$this->app = $app;
error_reporting(-1);
set_error_handler([$this, 'handleError']);
set_exception_handler([$this, 'handleException']);
register_shutdown_function([$this, 'handleShutdown']);
if (! $app->environment('testing')) {
ini_set('display_errors', 'Off');
}
}
public function handleError($level, $message, $file = '', $line = 0, $context = [])
{
if (error_reporting() $level) {
throw new ErrorException($message, 0, $level, $file, $line);
}
}
}
set_exception_handler([$this, 'handleException'])將HandleExceptions的handleException方法注冊為程序的全局處理器方法:
public function handleException($e)
{
if (! $e instanceof Exception) {
$e = new FatalThrowableError($e);
}
$this->getExceptionHandler()->report($e);
if ($this->app->runningInConsole()) {
$this->renderForConsole($e);
} else {
$this->renderHttpResponse($e);
}
}
protected function getExceptionHandler()
{
return $this->app->make(ExceptionHandler::class);
}
// 渲染CLI請求的異常響應(yīng)
protected function renderForConsole(Exception $e)
{
$this->getExceptionHandler()->renderForConsole(new ConsoleOutput, $e);
}
// 渲染HTTP請求的異常響應(yīng)
protected function renderHttpResponse(Exception $e)
{
$this->getExceptionHandler()->render($this->app['request'], $e)->send();
}
在處理器里主要通過ExceptionHandler的report方法上報異常、這里是記錄異常到storage/laravel.log文件中，然后根據(jù)請求類型渲染異常的響應(yīng)生成輸出給到客戶端。這里的ExceptionHandler就是\App\Exceptions\Handler類的實(shí)例，它是在項目最開始注冊到服務(wù)容器中的：
// bootstrap/app.php
/*
|--------------------------------------------------------------------------
| Create The Application
|--------------------------------------------------------------------------
*/
$app = new Illuminate\Foundation\Application(
realpath(__DIR__.'/../')
);
/*
|--------------------------------------------------------------------------
| Bind Important Interfaces
|--------------------------------------------------------------------------
*/
......
$app->singleton(
Illuminate\Contracts\Debug\ExceptionHandler::class,
App\Exceptions\Handler::class
);
這里再順便說一下set_error_handler函數(shù)，它的作用是注冊錯誤處理器函數(shù)，因?yàn)樵谝恍┠甏眠h(yuǎn)的代碼或者類庫中大多是采用PHP那件函數(shù)trigger_error函數(shù)來拋出錯誤的，異常處理器只能處理Exception不能處理Error，所以為了能夠兼容老類庫通常都會使用set_error_handler注冊全局的錯誤處理器方法，在方法中捕獲到錯誤后將錯誤轉(zhuǎn)化成異常再重新拋出，這樣項目中所有的代碼沒有被正確執(zhí)行時都能拋出異常實(shí)例了。
/**
* Convert PHP errors to ErrorException instances.
*
* @param int $level
* @param string $message
* @param string $file
* @param int $line
* @param array $context
* @return void
*
* @throws \ErrorException
*/
public function handleError($level, $message, $file = '', $line = 0, $context = [])
{
if (error_reporting() $level) {
throw new ErrorException($message, 0, $level, $file, $line);
}
}
常用的Laravel異常實(shí)例
Laravel中針對常見的程序異常情況拋出了相應(yīng)的異常實(shí)例，這讓開發(fā)者能夠捕獲這些運(yùn)行時異常并根據(jù)自己的需要來做后續(xù)處理（比如：在catch中調(diào)用另外一個補(bǔ)救方法、記錄異常到日志文件、發(fā)送報警郵件、短信）
在這里我列一些開發(fā)中常遇到異常，并說明他們是在什么情況下被拋出的，平時編碼中一定要注意在程序里捕獲這些異常做好異常處理才能讓程序更健壯。
- Illuminate\Database\QueryException Laravel中執(zhí)行SQL語句發(fā)生錯誤時會拋出此異常，它也是使用率最高的異常，用來捕獲SQL執(zhí)行錯誤，比方執(zhí)行Update語句時很多人喜歡判斷SQL執(zhí)行后判斷被修改的行數(shù)來判斷UPDATE是否成功，但有的情景里執(zhí)行的UPDATE語句并沒有修改記錄值，這種情況就沒法通過被修改函數(shù)來判斷UPDATE是否成功了，另外在事務(wù)執(zhí)行中如果捕獲到QueryException 可以在catch代碼塊中回滾事務(wù)。
- Illuminate\Database\Eloquent\ModelNotFoundException 通過模型的findOrFail和firstOrFail方法獲取單條記錄時如果沒有找到會拋出這個異常(find和first找不到數(shù)據(jù)時會返回NULL)。
- Illuminate\Validation\ValidationException 請求未通過Laravel的FormValidator驗(yàn)證時會拋出此異常。
- Illuminate\Auth\Access\AuthorizationException 用戶請求未通過Laravel的策略（Policy）驗(yàn)證時拋出此異常
- Symfony\Component\Routing\Exception\MethodNotAllowedException 請求路由時HTTP Method不正確
- Illuminate\Http\Exceptions\HttpResponseException Laravel的處理HTTP請求不成功時拋出此異常
擴(kuò)展Laravel的異常處理器
上面說了Laravel把\App\Exceptions\Handler 注冊成功了全局的異常處理器，代碼中沒有被catch到的異常，最后都會被\App\Exceptions\Handler捕獲到，處理器先上報異常記錄到日志文件里然后渲染異常響應(yīng)再發(fā)送響應(yīng)給客戶端。但是自帶的異常處理器的方法并不好用，很多時候我們想把異常上報到郵件或者是錯誤日志系統(tǒng)中，下面的例子是將異常上報到Sentry系統(tǒng)中，Sentry是一個錯誤收集服務(wù)非常好用：
public function report(Exception $exception)
{
if (app()->bound('sentry') $this->shouldReport($exception)) {
app('sentry')->captureException($exception);
}
parent::report($exception);
}
還有默認(rèn)的渲染方法在表單驗(yàn)證時生成響應(yīng)的JSON格式往往跟我們項目里統(tǒng)一的JOSN格式不一樣這就需要我們自定義渲染方法的行為。
public function render($request, Exception $exception)
{
//如果客戶端預(yù)期的是JSON響應(yīng), 在API請求未通過Validator驗(yàn)證拋出ValidationException后
//這里來定制返回給客戶端的響應(yīng).
if ($exception instanceof ValidationException $request->expectsJson()) {
return $this->error(422, $exception->errors());
}
if ($exception instanceof ModelNotFoundException $request->expectsJson()) {
//捕獲路由模型綁定在數(shù)據(jù)庫中找不到模型后拋出的NotFoundHttpException
return $this->error(424, 'resource not found.');
}
if ($exception instanceof AuthorizationException) {
//捕獲不符合權(quán)限時拋出的 AuthorizationException
return $this->error(403, "Permission does not exist.");
}
return parent::render($request, $exception);
}
自定義后，在請求未通過FormValidator驗(yàn)證時會拋出ValidationException， 之后異常處理器捕獲到異常后會把錯誤提示格式化為項目統(tǒng)一的JSON響應(yīng)格式并輸出給客戶端。這樣在我們的控制器中就完全省略了判斷表單驗(yàn)證是否通過如果不通過再輸出錯誤響應(yīng)給客戶端的邏輯了，將這部分邏輯交給了統(tǒng)一的異常處理器來執(zhí)行能讓控制器方法瘦身不少。
使用自定義異常
這部分內(nèi)容其實(shí)不是針對Laravel框架自定義異常，在任何項目中都可以應(yīng)用我這里說的自定義異常。
我見過很多人在Repository或者Service類的方法中會根據(jù)不同錯誤返回不同的數(shù)組，里面包含著響應(yīng)的錯誤碼和錯誤信息，這么做當(dāng)然是可以滿足開發(fā)需求的，但是并不能記錄發(fā)生異常時的應(yīng)用的運(yùn)行時上下文，發(fā)生錯誤時沒辦法記錄到上下文信息就非常不利于開發(fā)者進(jìn)行問題定位。
下面的是一個自定義的異常類
namespace App\Exceptions\;
use RuntimeException;
use Throwable;
class UserManageException extends RuntimeException
{
/**
* The primitive arguments that triggered this exception
*
* @var array
*/
public $primitives;
/**
* QueueManageException constructor.
* @param array $primitives
* @param string $message
* @param int $code
* @param Throwable|null $previous
*/
public function __construct(array $primitives, $message = "", $code = 0, Throwable $previous = null)
{
parent::__construct($message, $code, $previous);
$this->primitives = $primitives;
}
/**
* get the primitive arguments that triggered this exception
*/
public function getPrimitives()
{
return $this->primitives;
}
}
定義完異常類我們就能在代碼邏輯中拋出異常實(shí)例了
class UserRepository
{
public function updateUserFavorites(User $user, $favoriteData)
{
......
if (!$executionOne) {
throw new UserManageException(func_get_args(), 'Update user favorites error', '501');
}
......
if (!$executionTwo) {
throw new UserManageException(func_get_args(), 'Another Error', '502');
}
return true;
}
}
class UserController extends ...
{
public function updateFavorites(User $user, Request $request)
{
.......
$favoriteData = $request->input('favorites');
try {
$this->userRepo->updateUserFavorites($user, $favoritesData);
} catch (UserManageException $ex) {
.......
}
}
}
除了上面Repository列出的情況更多的時候我們是在捕獲到上面列舉的通用異常后在catch代碼塊中拋出與業(yè)務(wù)相關(guān)的更細(xì)化的異常實(shí)例方便開發(fā)者定位問題，我們將上面的updateUserFavorites 按照這種策略修改一下
public function updateUserFavorites(User $user, $favoriteData)
{
try {
// database execution
// database execution
} catch (QueryException $queryException) {
throw new UserManageException(func_get_args(), 'Error Message', '501' , $queryException);
}
return true;
}
在上面定義UserMangeException類的時候第四個參數(shù)$previous是一個實(shí)現(xiàn)了Throwable接口類實(shí)例，在這種情景下我們因?yàn)椴东@到了QueryException的異常實(shí)例而拋出了UserManagerException的實(shí)例，然后通過這個參數(shù)將QueryException實(shí)例傳遞給PHP異常的堆棧，這提供給我們回溯整個異常的能力來獲取更多上下文信息，而不是僅僅只是當(dāng)前拋出的異常實(shí)例的上下文信息， 在錯誤收集系統(tǒng)可以使用類似下面的代碼來獲取所有異常的信息。
while($e instanceof \Exception) {
echo $e->getMessage();
$e = $e->getPrevious();
}
異常處理是PHP非常重要但又容易讓開發(fā)者忽略的功能，這篇文章簡單解釋了Laravel內(nèi)部異常處理的機(jī)制以及擴(kuò)展Laravel異常處理的方式方法。更多的篇幅著重分享了一些異常處理的編程實(shí)踐，這些正是我希望每個讀者都能看明白并實(shí)踐下去的一些編程習(xí)慣，包括之前分享的Interface的應(yīng)用也是一樣。
總結(jié)
以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，如果有疑問大家可以留言交流，謝謝大家對腳本之家的支持。
您可能感興趣的文章:- 如何重寫Laravel異常處理類詳解
- Laravel如何實(shí)現(xiàn)適合Api的異常處理響應(yīng)格式
- Laravel 修改驗(yàn)證異常的響應(yīng)格式實(shí)例代碼詳解
- laravel框架使用FormRequest進(jìn)行表單驗(yàn)證，驗(yàn)證異常返回JSON操作示例
- Laravel 解決composer相關(guān)操作提示php相關(guān)異常的問題
- Laravel 5.5 異常處理 & 錯誤日志的解決
- 解決laravel 表單提交-POST 異常的問題
- laravel框架 api自定義全局異常處理方法
- 淺談Laravel中使用Slack進(jìn)行異常通知
