Download the PHP package eonx-com/apiformats without Composer
On this page you can find all versions of the php package eonx-com/apiformats. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package apiformats
API Formats
Installation
Use Composer to install the package in your project:
Formats
By default the package handle JSON (application/json) and XML (application/xml, text/xml) formats.
If you want to handle different formats or want to implement your own JSON/XML encoding logic, the only thing
you need to do is creating your encoder implementing \EoneoPay\ApiFormats\Interfaces\RequestEncoderInterface
and
tell the package to use it, with which Mime types as explained in the Configuration section.
Integration
Laravel
To integrate the package into your Laravel or Lumen you need to register the following service provider and middleware:
- ServiceProvider:
\EoneoPay\ApiFormats\Bridge\Laravel\Providers\ApiFormatsServiceProvider
- Middleware:
\EoneoPay\ApiFormats\Bridge\Laravel\Middlewares\ApiFormatsMiddleware
That's it! Your application is now able to easily receive requests and generate responses in several formats.
Formatted Api Response
If you want to customise the generated response as its status code or headers without handling
body encoding yourself, the package provides the \EoneoPay\ApiFormats\Bridge\Laravel\Responses\FormattedApiResponse
object you can return from your controllers/middlewares. The FormattedApiResponse
accept three parameters through its
constructor as following:
- $content (mixed): array or object able to be cast as an array
- $statusCode (int): status code of response, default as 200
- $headers (array): headers of response, default as empty array
Configuration
The philosophy of the package is to map encoders to a list of MIME types that they can handle through an array as following:
Each MIME type can be the exact name as application/json
or a Regex
used to match multiple MIME types as application/vnd.eoneopay.v[0-9]+\+json
.
Laravel
To configure supported formats in your application, create a api-formats.php
config file with a formats
array using the encoders class as key and array of associated Mime types as value:
All versions of apiformats with dependencies
doctrine/inflector Version ^1.3
eonx-com/utils Version ^1.0 || ^2.0
ext-json Version *
laminas/laminas-diactoros Version ^2.1
league/fractal Version ^0.17.0 || ^0.19
symfony/psr-http-message-bridge Version ^1.0
woohoolabs/yang Version ^1.4