Contributte Apitte

# Throwing errors

To display errors to user use our prepared ApiException, specifically:

ClientErrorException for user errors (400-499)
ServerErrorException for server errors (500-599)

Other errors are transformed into a generic exception (see SimpleErrorHandler docs for more info)

Known limitation: Currently could be returned this way only single error not mixed with data. This limitation will be solved in near future. As a workaround you can set exact response content you want, without any special handling inside apitte.

# Error handler

Error handler is responsible for catching all errors and transforming them into response (if none of exception decorators was able to do it)

# SimpleErrorHandler

Default error handler

Transforms error into json response
- ApiException (and inherited errors like ClientErrorException) message, context and code are used directly in response
- For other (non-api) errors is used generic message described bellow
- Context is send only if is not empty
```
{
  "status": "error",
  "code": 500,
  "message": "Application encountered an internal error. Please try again later.",
  "context": []
}
```
  1
  2
  3
  4
  5
  6
Allows rethrow error in debug mode (see catchException option in setup)

# PsrLogErrorHandler

Extends SimpleErrorHandler for logging of errors.

It is activated automatically if you have an autowired Psr\Log\LoggerInterface implementation in DI container (like contributte/monolog (opens new window) or PSR adapter of tracy (opens new window))