项目中的自定义异常处理总结错误页面&API错误

前言
一、异常分类
- 1. 控制器找不到
- 2. 方法找不到
- 3. 请求资源不存在
- 4. 系统內部异常、HTTP异常等
二、异常处理
- 1. 前置处理
- 2. 异常处理详细代码
- - (1) 控制器找不到
  - (2) 方法找不到
  - (3) 请求资源不存在及系统错误异常
三、异常检测

前言

一般项目中路由分为返回模板引擎页面和返回api接口json数据，两种方式异常需要返回不同的内容，如果是模板引擎页面遇到异常需要返回错误页面，如果是api接口遇到异常需要返回json数据。
开发模式和上线模式应该返回不同的内容，开发模式应该尽可能返回具体的错误信息，上线模式则不能返回具体的错误信息，一般显示“服务器错误，请稍后重试”类似友好的提示，而不是显示一堆报错代码（既不友好又不安全）。
如果有更好的方法，欢迎提出意见。

一、异常分类

1. 控制器找不到

在访问路由时，若控制器不对，需要使用空控制器拦截报错。

2. 方法找不到

方法找不到可以修改app目录下的BaseController控制器重写__call方法。

3. 请求资源不存在

自定义拦截报错信息，可以使用Provider自定义错误处理类，重写render方法，根据不同的错误返回不同的数据。

4. 系统內部异常、HTTP异常等

同第3点。

二、异常处理

1. 前置处理

(1) .env文件定义APP_DEBUG区分开发模式和线上模式，true表示开发模式，false表示线上模式：

APP_DEBUG = true

(2) 在app/common.php 文件定义api返回的数据格式：

function show($status, $message = 'error', $data = [], $httpStatus = 200){$result = ["status" => $status,"message" => $message,"result" => $data];return json($result, $httpStatus);
}

(3) 在当前应用下新建一个provider.php，并指定自定义异常处理类：

<?php// 容器Provider定义文件
return ['think\exception\Handle' => 'app\\admin\\exception\\Http',
];

(4) 定义状态码配置，可以在config文件夹下新建status.php添加相应的状态码配置：

<?phpreturn ["success" => 1,"error" => 0,"http_status" => ["not_found" => 404,"validate_error" => 422,"internal_error" => 500]
];

(5) 准备错误页面（404，500等）

2. 异常处理详细代码

(1) 控制器找不到

在app/controller目录新建Error类(文件名固定为Error)：

这里需要注意的是，多应用的控制器应该定义在应用文件夹里，这里定义在app目录是为了作用于app下全部应用。

<?phpnamespace app\controller;class Error
{public function __call($name, $arguments){if(request()->isAjax()){return show(config("status.error"), env('app_debug') ? "控制器{$name}找不到" : '当前请求资源不存在，请稍后再试', [], config("status.http_status.not_found"));}else{return view(root_path() . 'public/error/admin/404.html', ['e' => env('app_debug') ? "控制器{$name}找不到" : '当前请求资源不存在，请稍后再试'], config("status.http_status.not_found"));}}
}

(2) 方法找不到

在app/BaseController.php 控制器添加 __call 方法：

public function __call($name, $arguments){if(request()->isAjax()){return show(config("status.error"), env('app_debug') ? "找不到{$name}方法" : '当前请求资源不存在，请稍后再试', [], config("status.http_status.not_found"));}else{return view(root_path() . 'public/error/admin/404.html', ['e' => env('app_debug') ? "{$name}方法找不到" : '当前请求资源不存在，请稍后再试'], config("status.http_status.not_found"));}}

(3) 请求资源不存在及系统错误异常

app\\admin\\exception\\Http：

<?phpnamespace app\admin\exception;
use ErrorException;
use Exception;
use InvalidArgumentException;
use ParseError;
use PDOException;
use think\exception\ClassNotFoundException;
use think\exception\Handle;
use think\exception\HttpException;
use think\exception\RouteNotFoundException;
use think\Response;
use Throwable;
use TypeError;class Http extends Handle
{/*** Render an exception into an HTTP response.** @access public* @param \think\Request   $request* @param Throwable $e* @return Response*/public function render($request, Throwable $e): Response{$returnCode = config("status.error");$returnMessage = "系统异常，请稍后再试";$returnData = [];$httpStatus = 500;if($e instanceof BusinessException){ // 自定义添加的业务异常$returnMessage = $e->getMessage();$httpStatus = config("status.http_status.business_error");}else if($e instanceof ValidateException){$returnMessage = $e->getError();$httpStatus = config("status.http_status.validate_error");}else if (($e instanceof ClassNotFoundException || $e instanceof RouteNotFoundException) || ($e instanceof HttpException && $e->getStatusCode() == 404)) {$returnMessage = env('app_debug') ? $e->getMessage() : '当前请求资源不存在，请稍后再试';$httpStatus = config("status.http_status.not_found");}else if ($e instanceof Exception || $e instanceof PDOException || $e instanceof InvalidArgumentException || $e instanceof ErrorException || $e instanceof ParseError || $e instanceof TypeError || ($e instanceof HttpException && $e->getStatusCode() == 500)) {$returnMessage = env('app_debug') ? $e->getMessage() : '系统异常，请稍后再试';$httpStatus = config("status.http_status.internal_error");}if(request()->isAjax()){return show($returnCode, $returnMessage, $returnData, $httpStatus);}else{if($httpStatus == config("status.http_status.not_found")){$errorUrl = 'public/error/admin/404.html';}else{$errorUrl = 'public/error/admin/error.html';}return view(root_path() . $errorUrl, ['e'=>$returnMessage], $httpStatus);}}
}

以上代码中返回的错误信息e，需要在错误页面（404，error）显示：

<p class="error-message">{$e ?? ''}</p>

三、异常检测

异常检测分浏览器页面访问异常和api接口返回异常，还需要检查开发模式和线上模式。

控制器不存在
方法不存在
主动抛出异常
系统抛出异常

Tips: api接口可以使用Postman工具模拟，添加Headers：
Content-Type 为 application/x-www-form-urlencoded
X-Requested-With 为 xmlhttprequest

(博主比较懒就不贴截图了，但是都测试过，同志们自己试一下，算了还是贴一张吧)

⭐️重磅推荐：免费商用电商系统

ThinkPHP6项目基操（13.实战部分项目中的自定义异常处理总结错误页面API错误）相关推荐

ThinkPHP6项目基操（15.实战部分阿里云短信redis）
阿里云短信redis 一.安装阿里云短信SDK 二.封装到项目lib中三.radis记录验证码 1. 安装redis服务 2. 可视化redis管理软件 3. PHP安装redis扩展 4. 配置缓 ...
ThinkPHP6项目基操目录
前言 ThinkPHP是一个免费开源的,快速.简单的面向对象的轻量级PHP开发框架,是为了敏捷WEB应用开发和简化企业应用开发而诞生的.ThinkPHP从诞生以来一直秉承简洁实用的设计原则,在保持出色 ...
ThinkPHP6项目基操（11.实战部分部署后台静态页面模板及后台登录页面）
实战部分部署后台静态页面模板及后台登录页面前言一.部署静态资源到项目 1.新建后台静态资源文件夹二.后台登录页面 1. 目录结构 2. 模板字符串替换配置前言网站后台一般是在基础静态页面上 ...
ThinkPHP6项目基操（4.拦截无效请求控制器或方法不存在）
拦截无效请求控制器或方法不存在一.默认无效请求二.显示具体错误信息方法1.配置`config/app.php` 方法2. 配置`.env`环境变量三.处理错误 1. 方法不存在 2. 控制器 ...
php登陆项目,ThinkPHP6项目基操（14.实战部分中间件处理登录流程）
一.定义中间件 namespace app\middleware; class Check { public function handle($request, \Closure $next) { i ...
ThinkPHP6项目基操（20.实战部分数据库操作返回值总结）
数据库操作返回值总结 0. 前言 1. Db类操作数据库 1.1 新增 1.2 更新 1.3 删除 1.3.1 单条删除 1.3.2 批量删除 1.4 查询 1.4.1 单笔记录 1.4.2 多笔记录 ...
ThinkPHP6项目基操（19.实战部分 Mysql模型事务操作）
模型事务操作前言 1. Mysql数据库注意 2. thinkPHP模型使用事务前言事务操作在复杂的数据库操作的时候尤为重要,特别是在操作多张表的时候,如果某一步骤出错了,就会导致有脏数据,会很 ...
ThinkPHP6项目基操（18.实战部分表单令牌Token 防CSRF）
表单令牌Token 0. 前言 1. TP6 令牌token使用 1.1 表单提交 1.2 AJAX提交 2. TP6 令牌token验证 2.1 路由验证 2.2 控制器验证 2.3 验证器验证 0 ...
ThinkPHP6项目基操（17.实战部分 Filesystem文件上传）
Filesystem文件上传控制器: <?php namespace app\admin\controller; use app\BaseController; use think\facad ...

ThinkPHP6项目基操（13.实战部分项目中的自定义异常处理总结错误页面API错误）

项目中的自定义异常处理总结错误页面&API错误

前言

一、异常分类

1. 控制器找不到

2. 方法找不到

3. 请求资源不存在

4. 系统內部异常、HTTP异常等

二、异常处理

1. 前置处理

2. 异常处理详细代码

(1) 控制器找不到

(2) 方法找不到

(3) 请求资源不存在及系统错误异常

三、异常检测

ThinkPHP6项目基操（13.实战部分项目中的自定义异常处理总结错误页面API错误）相关推荐

最新文章

热门文章

ThinkPHP6项目基操（13.实战部分 项目中的自定义异常处理总结 错误页面API错误）

项目中的自定义异常处理总结 错误页面&API错误

前言

一、异常分类

1. 控制器找不到

2. 方法找不到

3. 请求资源不存在

4. 系统內部异常、HTTP异常等

二、异常处理

1. 前置处理

2. 异常处理详细代码

(1) 控制器找不到

(2) 方法找不到

(3) 请求资源不存在及系统错误异常

三、异常检测

ThinkPHP6项目基操（13.实战部分 项目中的自定义异常处理总结 错误页面API错误）相关推荐

最新文章

热门文章

ThinkPHP6项目基操（13.实战部分项目中的自定义异常处理总结错误页面API错误）

项目中的自定义异常处理总结错误页面&API错误

ThinkPHP6项目基操（13.实战部分项目中的自定义异常处理总结错误页面API错误）相关推荐