6异常处理
未知
2021-07-04 11:36:34
0

和PHP默认的异常处理不同,ThinkPHP抛出的不是单纯的错误信息,而是一个人性化的错误页面。

异常显示

新版的异常页面显示会自动判断当前的请求是否为Json请求,如果是JSON请求则采用JSON格式输出异常信息,否则按照HTML格式输出。

在调试模式下,系统默认展示的异常页面:

只有在调试模式下面才能显示具体的错误信息,如果在部署模式下面,你可能看到的是一个简单的提示文字,例如:

你可以通过设置exception_tmpl配置参数来自定义你的异常页面模板,默认的异常模板位于:

thinkphp/tpl/think_exception.tpl
复制

你可以在应用配置文件app.php中更改异常模板

// 自定义异常页面的模板文件
'exception_tmpl'         => \think\facade\App::getAppPath() . 'template/exception.tpl',
复制

默认的异常页面会返回500状态码,如果是一个HttpException异常则会返回HTTP的错误状态码。

异常处理接管

本着严谨的原则,框架会对任何错误(包括警告错误)抛出异常。系统产生的异常和错误都是程序的隐患,要尽早排除和解决,而不是掩盖。对于应用自己抛出的异常则做出相应的捕获处理。

框架支持异常处理由开发者自定义类进行接管,需要在app目录下面的provider.php文件中绑定异常处理类,例如:

    // 绑定自定义异常处理handle类
    'think\exception\Handle'       => '\\app\\exception\\Http',
复制

自定义类需要继承think\exception\Handle并且实现render方法,可以参考如下代码:

<?php
namespace app\common\exception;

use think\exception\Handle;
use think\exception\HttpException;
use think\exception\ValidateException;
use think\Response;
use Throwable;

class Http extends Handle
{
    public function render($request, Throwable $e): Response
    {
        // 参数验证错误
        if ($e instanceof ValidateException) {
            return json($e->getError(), 422);
        }

        // 请求异常
        if ($e instanceof HttpException && $request->isAjax()) {
            return response($e->getMessage(), $e->getStatusCode());
        }

        // 其他错误交给系统处理
        return parent::render($request, $e);
    }

}
复制

自定义异常处理的主要作用是根据不同的异常类型发送不同的状态码和响应输出格式。

事实上,默认安装应用后,已经帮你内置了一个app\ExceptionHandle异常处理类,直接修改该类的相关方法即可完成应用的自定义异常处理机制。

需要注意的是,如果自定义异常处理类没有再次调用系统render方法的话,配置http_exception_template就不再生效,具体可以参考Handle类内实现的功能。

手动抛出和捕获异常

ThinkPHP大部分情况异常都是自动抛出和捕获的,你也可以手动使用throw来抛出一个异常,例如:

// 使用think自带异常类抛出异常
throw new \think\Exception('异常消息', 10006);
复制

手动捕获异常方式是使用try-catch,例如:

try {
    // 这里是主体代码
} catch (ValidateException $e) {
    // 这是进行验证异常捕获
    return json($e->getError());
} catch (\Exception $e) {
    // 这是进行异常捕获
    return json($e->getMessage());
}
复制

支持使用try-catch-finally结构捕获异常。

HTTP 异常

可以使用\think\exception\HttpException类来抛出异常
框架提供了一个abort助手函数快速抛出一个HTTP异常:

<?php
namespace app\index\controller;


class Index
{
    public function index()
    {
      // 抛出 HTTP 异常
      throw new \think\exception\HttpException(404, '异常消息');
    }
}
复制

系统提供了助手函数abort简化HTTP异常的处理,例如:
框架提供了一个abort助手函数快速抛出一个HTTP异常:

<?php
namespace app\index\controller;


class Index
{
    public function index()
    {
        // 抛出404异常
        abort(404, '页面异常');
    }
}
复制

如果你的应用是API接口,那么请注意在客户端首先判断HTTP状态码是否正常,然后再进行数据处理,当遇到错误的状态码的话,应该根据状态码自行给出错误提示,或者采用下面的方法进行自定义异常处理。

部署模式下一旦抛出了HttpException异常,可以定义单独的异常页面模板,只需要在app.php配置文件中增加:

'http_exception_template'    =>  [
    // 定义404错误的模板文件地址
    404 =>  \think\facade\App::getAppPath() . '404.html',
    // 还可以定义其它的HTTP status
    401 =>  \think\facade\App::getAppPath() . '401.html',
]
复制

模板文件支持模板引擎中的标签。

http_exception_template配置仅在部署模式下面生效。

上一篇:6视图驱动

下一篇:6日志处理

相关内容

巴西音乐人邀请西安外事鼓乐...
巴西音乐家与西安外事鼓乐团合作,共谱文化交响,融合东西方音乐元素,...
2024-11-20 21:23:35
MySQL变量的生命周期管...
MySQL变量管理关键在于生命周期控制。需了解全局、会话及用户自定...
2024-11-20 20:46:37
MySQL变量的作用域与访...
摘要: MySQL变量具有作用域和访问控制,局部变量限于特定上下...
2024-11-20 20:00:40
动态分配MySQL变量的示...
MySQL中,变量用于存储临时数据,包括全局和会话变量以及用户定义...
2024-11-20 18:23:38
MySQL变量存储的数据类...
MySQL支持多种数据类型以存储不同种类的变量,包括数值型、字符串...
2024-11-20 18:00:48
MySQL变量在数据库操作...
MySQL变量在数据库操作中至关重要,用于存储数据、配置操作、实现...
2024-11-20 17:46:42

热门资讯

tp6开发规范 命名规范 请理解并尽量遵循以下命名规范,可以减少在开发过程中出现不必要的错误。 ThinkPHP6....
6高级查询 快捷查询 快捷查询方式是 一种多字段相同查询条件 的简化写法,可以进一步简化查询条件的写法,在多个字...
tp6多应用提示控制器不存在:... 第一个情况是没有使用composer安装扩展。 如果要使用多应用模式, 你需要win+r,cmd指针...
6配置 配置目录 单应用模式 对于单应用模式来说,配置文件和目录很简单,根目录下的 config 目录下面就...
6异常处理 和PHP默认的异常处理不同,ThinkPHP抛出的不是单纯的错误信息,而是一个人性化的错误页面。 异...
6swoole 本篇内容主要讲述了最新的 think-swoole 扩展的使用。目前仅支持Linux环境或者MacO...
6助手函数 助手函数 系统为一些常用的操作方法封装了助手函数,便于使用,包含如下: 助手函数 描述 abort ...
6查询表达式 查询表达式 查询表达式支持大部分的SQL查询语法,也是 ThinkPHP 查询语言的精髓,查询表达式...
6路由参数 路由参数 路由分组及规则定义支持指定路由参数,这些参数主要完成路由匹配检测以及后续行为。 路由参数可...
6查询 模型查询和数据库查询方法的区别主要在于,模型中的查询的数据在获取的时候会经过获取器的处理,以及更加对...