free-elephants/json-api-toolkit

Tools for building specification first json:api / swagger integrated APIs

0.0.14 2021-02-02 13:23 UTC

Requires

• ext-intl: *
• ext-json: *
• cebe/php-openapi: 1.4.*
• fig/http-message-util: ^1.1
• free-elephants/i18n: ^0.0.1
• laminas/laminas-stratigility: ^3.2
• league/openapi-psr7-validator: 0.14
• neomerx/json-api: ^4.0
• nette/php-generator: ^3.4
• nikic/fast-route: ^1.3
• psr/cache: ^1.0
• psr/http-factory: ^1.0
• psr/http-message: ^1.0
• psr/http-server-handler: ^1.0
• psr/http-server-middleware: ^1.0
• rakit/validation: ^1.2
• ramsey/uuid: ^3.0|^4.0

Requires (Dev)

• doctrine/orm: ^2.7
• helmich/phpunit-psr7-assert: dev-master#c7c75e8
• nyholm/psr7: ^1.2
• phpunit/phpunit: ^9.0

Suggests

• doctrine/orm: ^2.7
• free-elephants/di: *
• laminas/laminas-httphandlerrunner: *

BSD-2-Clause

• samizdam

README

Features:

• Build FastRoute Dispatcher by defined in OAS3 operationsIds values
• Serialize Doctrine entities with Neomerx schemas (resolve issue neomerx/json-api#40)
• Generate PHP Data Transfer Objects by OAS3 reponseBody and requestBody schema reference compliance with json:api
• Map Psr Requests to Data Transfer Objects
• Validate incoming Psr Requests with swagger specification and user defined rules, and build Psr Response with json:api errors
• Map application models to Psr Response compliance with json:api structure

Usage

Install

composer require free-elephants/json-api-toolkit

Documentation

Available in /docs.

Index:

1. Routing
2. Serialize doctrine entities
3. DTO from psr server request
4. Validation

Development

All dev env is dockerized. Your can use make receipts and bin/ scripts without locally installed php, composer.

For run tests with different php version change PHP_VERSION value in .env and rebuild image with make build.