500 系统错误处理器

Edit This Page

出问题了!你并不能预知错误,但你可以预料到。每个 Slime 框架应用程序都有一个错误处理器用于接收所有未抓取的 PHP 异常。这个错误处理器同样能接收当前 HTTP 的请求对象和响应对象。这个错误处理器必须预备并返回一个适当的响应对象,这个对象会被返回到 HTTP 客户端。

默认的错误处理器

默认的错误处理器非常基础。它将响应状态编码设置为 500,并将响应内容类型设置为 text/html,并将一个通用的错误信息加入到响应体中。

这个对于生产应用大概不太合适。强烈建议你实现专用于你的 Slim 应用程序的错误处理器。

默认的错误处理程序还可以包括详细的错误诊断信息。要启用这个功能你需要将 displayErrorDetails 设置为 true :

$configuration = [
 'settings' => [
 'displayErrorDetails' => true,
 ],
];
$c = new \Slim\Container($configuration);
$app = new \Slim\App($c);

自定义错误处理器

Slim 框架应用程序的错误处理器是一种 Pimple 服务。你可以通过应用程序容器对自定义 Pimple factory 方法进行定义,来创建自定义的错误处理器取代默认的。

有两种注入处理器的方法:

Pre App

$c = new \Slim\Container();
$c['errorHandler'] = function ($c) {
 return function ($request, $response, $exception) use ($c) {
 return $c['response']->withStatus(500)
 ->withHeader('Content-Type', 'text/html')
 ->write('Something went wrong!');
 };
};
$app = new \Slim\App($c);

Post App

$app = new \Slim\App();
$c = $app->getContainer();
$c['errorHandler'] = function ($c) {
 return function ($request, $response, $exception) use ($c) {
 return $c['response']->withStatus(500)
 ->withHeader('Content-Type', 'text/html')
 ->write('Something went wrong!');
 };
};

在这个例子中,我们定义了一个新的 errorHandler factory ,它将返回一个 callable 。返回的 callable 接收三个参数:

  1. 一个 \Psr\Http\Message\ServerRequestInterface 实例
  2. 一个 \Psr\Http\Message\ResponseInterface 实例
  3. 一个 \Exception 实例

这个 callable 必须 返回一个新的 \Psr\Http\Message\ResponseInterface 实例,对于给定的异常也是如此。

务必注意:下面这三个类型的异常不会被自定义的 errorHandler 处理:

  • Slim\Exception\MethodNotAllowedException: 这个可以用自定义的 notAllowedHandler 来处理。
  • Slim\Exception\NotFoundException: 这个可以用自定义的 notFoundHandler 来处理。
  • Slim\Exception\SlimException: 这种类型的异常是 Slim 内置的,它的处理不能被覆写。

禁用

要想彻底地禁用 Slim 的错误处理器,只需从容器中移除错误处理器即可:

unset($app->getContainer()['errorHandler']);

现在,你需要负责处理所有异常了,因为 Slim 已经不再处理它们。

powered by Gitbook 该教程制作时间: 2016-05-03 16:18:53