类 WebExceptionRenderer
Web 异常渲染器。
捕获并处理所有未处理的异常。当调试为 true 时，显示有用的框架错误。当调试为 false 时，WebExceptionRenderer 将渲染 404 或 500 错误。如果抛出未捕获的异常，并且它属于 WebExceptionHandler 不认识的类型，则将其视为 500 错误。
实现应用程序特定的异常渲染
您可以通过创建 WebExceptionRenderer 的子类并将其配置为 config/error.php 中的 exceptionRenderer 来实现应用程序特定的异常处理。
使用 WebExceptionRenderer 的子类
使用 WebExceptionRenderer 的子类可以让您完全控制异常的渲染方式，您可以在 config/app.php 中配置您的类。
属性摘要
-
$controller protected
Cake\Controller\Controller控制器实例。
-
$error protected
Throwable正在处理的异常。
-
$exceptionHttpCodes protected
array<string, int>异常到 http 状态码的映射。
-
$method protected
string与该对象所针对的异常相对应的函数名。
-
$request protected
Cake\Http\ServerRequest|null如果设置，这将是用于创建将渲染错误的控制器的请求。
-
$template protected
string用于渲染 {@link \Cake\Core\Exception\CakeException} 的模板
方法摘要
-
__construct() public
创建控制器以对错误响应执行渲染。
-
__debugInfo() public
返回一个数组，可用于描述此对象的内部状态。
-
_customMethod() protected
渲染自定义错误函数名/模板。
-
_getController() protected
获取处理异常的控制器实例。在子类中覆盖此函数名以自定义使用的控制器。此函数名通常返回内置的
ErrorController，或者如果错误重复，则将使用一个空的控制器。 -
_message() protected
获取错误消息。
-
_method() protected
获取函数名。
-
_outputMessage() protected
使用控制器对象生成响应。
-
_outputMessageSafe() protected
一种更安全的渲染错误消息的方法，用基本方法替换所有帮助器，并且不调用组件函数名。
-
_shutdown() protected
运行关闭事件。
-
_template() protected
获取用于渲染异常信息的模板。
-
clearOutput() protected
清除输出缓冲区，以便错误页面正确显示。
-
getHttpCode() protected
获取异常的适当 http 状态码。
-
render() public
渲染异常的响应。
-
write() public
发出响应内容
方法详情
__construct() ¶ public
__construct(Throwable $exception, Cake\Http\ServerRequest|null $request = null)创建控制器以对错误响应执行渲染。
参数
-
Throwable$exception 异常。
-
Cake\Http\ServerRequest|null$request 可选 请求，如果设置，它将用于代替创建一个新的请求。
__debugInfo() ¶ public
__debugInfo(): array<string, mixed>返回一个数组，可用于描述此对象的内部状态。
返回值
array<string, mixed>_customMethod() ¶ protected
_customMethod(string $method, Throwable $exception): Cake\Http\Response渲染自定义错误函数名/模板。
参数
-
string$method 要调用的函数名。
-
Throwable$exception 要渲染的异常。
返回值
Cake\Http\Response_getController() ¶ protected
_getController(): Cake\Controller\Controller获取处理异常的控制器实例。在子类中覆盖此函数名以自定义使用的控制器。此函数名通常返回内置的 ErrorController，或者如果错误重复，则将使用一个空的控制器。
返回值
Cake\Controller\Controller_message() ¶ protected
_message(Throwable $exception, int $code): string获取错误消息。
参数
-
Throwable$exception 异常。
-
int$code 错误代码。
返回值
string_method() ¶ protected
_method(Throwable $exception): string获取函数名。
参数
-
Throwable$exception 异常实例。
返回值
string_outputMessage() ¶ protected
_outputMessage(string $template): Cake\Http\Response使用控制器对象生成响应。
参数
-
string$template 要渲染的模板。
返回值
Cake\Http\Response_outputMessageSafe() ¶ protected
_outputMessageSafe(string $template): Cake\Http\Response一种更安全的渲染错误消息的方法，用基本方法替换所有帮助器，并且不调用组件函数名。
参数
-
string$template 要渲染的模板。
返回值
Cake\Http\Response_shutdown() ¶ protected
_shutdown(): Cake\Http\Response运行关闭事件。
触发 afterFilter 和 afterDispatch 事件。
返回值
Cake\Http\Response_template() ¶ protected
_template(Throwable $exception, string $method, int $code): string获取用于渲染异常信息的模板。
参数
-
Throwable$exception 异常实例。
-
string$method 函数名。
-
int$code 错误代码。
返回值
stringgetHttpCode() ¶ protected
getHttpCode(Throwable $exception): int获取异常的适当 http 状态码。
参数
-
Throwable$exception 异常。
返回值
intwrite() ¶ public
write(Psr\Http\Message\ResponseInterface|string $output): void发出响应内容
此函数名仅在全局默认异常处理程序处理异常时调用。
参数
-
Psr\Http\Message\ResponseInterface|string$output 要输出的响应。
返回值
void属性详情
$exceptionHttpCodes ¶ protected
异常到 http 状态码的映射。
对于不想让特定异常抛出 404 错误或希望自动转换应用程序异常的用户，可以自定义它。
类型
array<string, int>