new-inventor/http-tools

Codes and standard headers

1.1.0 2017-10-04 09:41 UTC

This package is not auto-updated.

Last update: 2024-04-24 01:31:36 UTC


README

This library provides exceptions, status codes, and common headers for http requests and responses.

All exceptions

  • extend NewInventor\HttpTools\Exception\HttpException
  • implement NewInventor\HttpTools\Exception\HttpExceptionInterface

The basic kind of HttpException is \RuntimeException.

All http exceptions have numeric code and symbolic code like 404 and 'NOT_FOUND'.

There are two types of the exceptions "Client" (4xx) and "Server" (5xx).

You can raise the exception with this code:

throw new NewInventor\HttpTools\Exception\Client\ForbiddenException('Your access rights are invalid.');

To get the status code:

$exception->getStatusCode();
$exception->getStatusCodeString();

You can use the StatusCode enumerations, for check the codes from another libraries. Like so:

if($response->getStatusCode() === NewInventor\HttpTools\StatusCode\ClientError::BAD_REQUEST){ ... }

You can use Header enumerations for paste headers in configuration.