# 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": []
  • 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))