500 系统错误处理器
最后更新于：2022-04-01 22:33:57
# 500 系统错误处理器
[Edit This Page](https://github.com/slimphp/Slim-Website/tree/gh-pages/docs/handlers/error.md)
出问题了！你并不能预知错误，但你可以预料到。每个 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`](/docs/handlers/not-allowed.html) 来处理。
* `Slim\Exception\NotFoundException`: 这个可以用自定义的 [`notFoundHandler`](/docs/handlers/not-found.html) 来处理。
* `Slim\Exception\SlimException`: 这种类型的异常是 Slim 内置的，它的处理不能被覆写。
### 禁用
要想彻底地禁用 Slim 的错误处理器，只需从容器中移除错误处理器即可：
```
unset($app->getContainer()['errorHandler']);
```
现在，你需要负责处理所有异常了，因为 Slim 已经不再处理它们。
';