Download the PHP package slexphp/simple-http-api-client without Composer
On this page you can find all versions of the php package slexphp/simple-http-api-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package simple-http-api-client
About
A simple PSR compatible PHP HTTP API client
Installation
Install via Composer by running composer require slexphp/simple-http-api-client
in your project directory.
Public API
Classes
Slexphp\Http\SimpleApiClient\Psr\JsonClientFactory\JsonApiClient
This class provides a static create()
method.
It accepts a psr client and request factory and creates an instance of ApiClientInterface
(see below)..
The create()
method with it's first two arguments (plus return type and thrown exception interfaces),
are the only part of public API of this library.
The actual returned class as well as any details behind it should not be relied upon at this point.
Interfaces
Slexphp\Http\SimpleApiClient\Contracts\ApiClientInterface
This is the main interface with which all your api clients will interact. It offers just one method with all parameters required to send a http request.
It will also process request body serialization and response body deserialization according to passed and received content-type headers.
Implementation should by default fallback to application/json content type request body serializer if no request content-type header is provided. Implementation should also by default fallback to application/json content type response body deserializer if no response content-type header is received from the server.
Nevertheless, passsing request content-type explicitly in request headers is recommended. Because using a default request body serializer doesn't imply adding default content-type header to the actual request.
Slexphp\Http\SimpleApiClient\Contracts\ApiResponseInterface
This interface describes the api response object.
It resembles PSR-7 \Psr\Http\Message\ResponseInterface
, but it has no mutator methods
and it offers getParsedBody()
method so that you dont need to worry about parsing.
Slexphp\Http\SimpleApiClient\Contracts\ApiClientExceptionInterface
This interface describes all possible errors that can occur during a http call or during (de)serialization of request/response messages.
Example
In this example we already created a client instance and we make a single http call. Then we show all the methods of the response/error api while we make all possible assertions that are always going to be true.
The ApiClientInterface implementation is a stateless service (as long as the underlying response factory and client are). You can use just one instance for all your backend-backend calls.
All versions of simple-http-api-client with dependencies
psr/http-factory Version ^1.0
psr/http-client Version ^1.0
slexphp/json-serialization Version ^1.0