The aim of this bundle is to act as a wrapper for any API library you want to use in Symfony. In this case with Guzzle, the most popular PHP HTTP client library.
It has never been so easy to consume an API than with this bundle.
This is where the encapsulation magic happens.
It has only one method send that sends the proper request to the API.
Used to create all different API clients. When defined it requires a base uri for the API as a simple string or an array of different url's. In case that an array is given, the factory will choose one of them randomly. This is kind of a basic basic load balancer implemented because of reasons.
It has to be used to send requests to API's. Using the different methods you will be able to set the request method (GET, POST, etc), set headers, set the endpoint, etc.
Object returned when successfully calling send method in Api. You can get the response status code, headers or body.
First things first, install package via composer:
composer require franjid/api-wrapper-bundle
And add the bundle to your AppKernel.php
new \Franjid\ApiWrapperBundle\ApiWrapperBundle(),
Example: adding an API for Xkcd API
You can check a project with example code using the bundle in this repository
First step is to define the API Client in your services config file
ApiClientXkcd:
class: ApiClientXkcd
factory: [@ApiWrapperBundle.Component.Api.ApiClientFactory, createApiClient]
arguments:
- %apiXkcdBaseURI%
That will create the ApiClientXkcd taking the parameter apiXkcdBaseURI and injecting it so we have a base URI.
apiXkcdBaseURI should be in the format
apiXkcdBaseURI: 'http://xkcd.com/'
Now is time to create the interface, then the service class and add it to your services config file
Service.Api.ApiXkcdServiceInterface:
class: AppBundle\Service\Api\ApiXkcdService
arguments:
- @ApiClientXkcd
At this moment you're ready to go for adding your awesome methods that will call the API.