oligus/jad

Json Api to Doctrine ORM

JAD

JSON Api :heart: Doctrine ORM, _(*1)

, _(*2)

JAD is a library created for rapid development of JSON API backend REST implementation. You can run JAD as a standalone server with php -S (see demo), or you can use it as a middleware in your framework., _(*3)

It turns doctrine entities (doctrine/doctrine2) to a JSON API resource, or collection of resources automagically., _(*4)

Requirements

You need to have Doctrine installed and preferably setup before you can use Jad., _(*5)

Install

composer require oligus/jad, _(*6)

Quick start

1. Annotate your entities that you want to expose to JSON-API:

/**
 * @ORM\Entity
 * @ORM\Table(name="albums")
 * @Jad\Map\Annotations\Header(type="albums")
 */
class Albums
{
...

1. Setup JAD using current entity manager.

$jad = new Jad(new Jad\Map\AnnotationMapper($em));
$jad->setPathPrefix('/api/v1/jad');
$jad->jsonApiResult();

1. Fetch results

GET /api/v1/jad/albums

Contents

Configure, _(*7)

Mapping your entities, _(*8)

Fetching the resources, _(*9)

Fetching resources with relationships, _(*10)

Creating a new resource, _(*11)

Updating a resource, _(*12)

Deleting resources / relationships, _(*13)

Validation, _(*14)

Support

Lumen

Support for lumen via middleware., _(*15)

In your Lumen bootstrap file (../lumen/bootstrap/app.php), _(*16)

// Jad middleware
$app->middleware([
    'jad' => Jad\Support\Lumen\JadMiddleWare::class,
]);

...

// Register Service Providers
$app->register(Jad\Support\Lumen\JadServiceProvider::class);

You can go with the default configuration or copy lumen/vendor/oligus/jad/src/Support/Lumen/jad.php to /lumen/config and change it there., _(*17)

Contributing

When contributing to this repository, please first discuss the change you wish to make via issue before making a pull request., _(*18)

Authors

• Oli Gustafsson - Initial work - oligus

License

This project is licensed under the MIT License - see the LICENSE file for details, _(*19)