trivago/jade

A simple but yet powerful library to expose your entities through JSON API.

Jade(Json Api Doctrine Exposer)

What is it?

Jade is a library created in an effort to create a simple way to create Json API server using doctrine entities. It supports all the CRUD functionality like filtering, sorting and including relationships. You just define the entities then using the configuration expose different routes., _(*1)

It is done in a way to be easy to customize any part you need., _(*2)

Another library?

Before starting developing this library we went through other available libraries even thinking about contributing to them. But the issue was that customizing those libraries to our needs was complicated and sometimes needed too much effort to even set it up. In case of Jade in 5 minutes you can have a fully functional API running., _(*3)

Getting started

You can find a quick start example in docs/example.md, _(*4)

First install the library:, _(*5)

composer require trivago/jade, _(*6)

Next add the bundle to the kernel:, _(*7)

<?php

public function registerBundles()
{
        $bundles = [
            ...
            new Trivago\Jade\Application\Framework\JadeBundle\TrivagoJadeBundle(),
            ...
        ];
}

And then add the routing, _(*8)

json_api_routes:
    prefix: /api
    resource: .
    type: json_api

And then you have to setup the configuration., _(*9)

Configuration

Read it here, _(*10)

Example configuration

Read it here, _(*11)

Entities

Read it here, _(*12)

Loading the routes

Read it here, _(*13)

Filtering

Read it here, _(*14)

Sorting

Read it here, _(*15)

Including

Read it here, _(*16)

Listeners

Read it here, _(*17)

Example calls

Read it here, _(*18)

Security concerns

Read it here, _(*19)

Tests

Read it here, _(*20)

Missing features

• Allow choosing which fields to be included.
• Validate the request for extra keys that are not valid.
• Create the relationship urls.
• Contain for a path that is string works fine. Find a new filter type name for path being an array that contains value.
• [IMPROVED] Use ResourceMapper to avoid filtering or sorting on columns that are not rendered [security]