innmind/rest-server-bundle

Symfony integration of innmind/rest-server

Saturday, September 30, 2017
by Baptouuuu
Repository
1 Watchers
0 Stars
116 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
15 Versions
0 % Grown

The README.md

REST Server Bundle

`master`	`develop`

, _(*1)

Installation

Via composer:, _(*2)

composer require innmind/rest-server-bundle

Enable the bundle by adding the following line in your app/AppKernel.php of your project:, _(*3)

// app/AppKernel.php

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Innmind\Rest\InnmindRestServerBundle,
        );
        // ...
    }
    // ...
}

Then you need to specify the types you allow in the app, here's an example:, _(*4)

innmind_rest_server:
    accept:
        json:
            priority: 10
            media_types:
                application/json: 0
        html:
            priority: 0
            media_types:
                text/html: 10
                application/xhtml+xml: 0
    content_type:
        json:
            priority: 0
            media_types:
                application/json: 0

Here you define you can expose your resources either in json or html. If the client accept any kind of content, it will automatically expose data as json as it has the highest priority. The client can use either text/html or application/xhtml+xml as media type in his Accept header in order for us to expose data as html., _(*5)

We also describe the fact resources sent to our API must me in json only, and that the Content-Type header sent by the client must be application/json otherwise he will get an error., _(*6)

In order to work properly, any media type here must have a corresponding serializer encoder (the supportsEnconding must check the request_{media_type} format, example)., _(*7)

Then you need to activate the router by adding this configuration:, _(*8)

# app/config/routing.yml
rest:
    type: innmind_rest
    resource: .

The last part of the configuration is to create a file named rest.yml in your bundle under the folder Resources/config that will contain the definition of your resources. Here's an extended example:, _(*9)

blog:
    resources:
        blog:
            identity: uuid
            gateway: command
            properties:
                uuid:
                    type: string
                title:
                    type: string
                    access: [READ, CREATE, UPDATE]
                content:
                    type: string
                    access: [READ, CREATE, UPDATE]
                tags:
                    type: set
                    options:
                        inner: string
                author:
                    type: string # identifier of the author
    children:
        meta:
            resources:
                author:
                    identity: uuid
                    gateway: command
                    properties:
                        uuid:
                            type: string
                        name:
                            type: string

Now that all the configuration is done, you need to create a service implementing the interface GatewayInterface and tag the service definition with innmind_rest_server.gateway along with an alias to your choosing; the alias is the one you'll use in the configuration of your resources as chown above (which in our case is command)., _(*10)

Such a service definition should look like this:, _(*11)

services:
    my_gateway:
        class: AppBundle\Gateway\MyGateway
        tags:
            - { name: innmind_rest_server.gateway, alias: command }

The Versions

30/09 2017

dev-master

9999999-dev http://github.com/Innmind/RestServerBundle

Symfony integration of innmind/rest-server

library rest-server-bundle

Symfony integration of innmind/rest-server

innmind/rest-server-bundle

The README.md

REST Server Bundle

Installation

The Versions

dev-master

The Requires

The Development Requires

by Baptiste Langlade

3.0.0

The Requires

The Development Requires

by Baptiste Langlade

dev-develop

The Requires

The Development Requires

by Baptiste Langlade

2.0.0

The Requires

The Development Requires

by Baptiste Langlade

1.1.1

The Requires

The Development Requires

by Baptiste Langlade

1.1.0

The Requires

The Development Requires

by Baptiste Langlade

1.0.8

The Requires

The Development Requires

by Baptiste Langlade

1.0.7

The Requires

The Development Requires

by Baptiste Langlade

1.0.6

The Requires

The Development Requires

by Baptiste Langlade

1.0.5

The Requires

The Development Requires

by Baptiste Langlade

1.0.4

The Requires

The Development Requires

by Baptiste Langlade

1.0.3

The Requires

The Development Requires

by Baptiste Langlade

1.0.2

The Requires

by Baptiste Langlade

1.0.1

The Requires

by Baptiste Langlade

1.0.0

The Requires

by Baptiste Langlade